@clonus/react-bindings 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Clonus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# @clonus/react-bindings
+
+React bindings for the Clonus Analytics SDK. This package provides React components and hooks to easily integrate Clonus analytics into your React applications.
+
+## Installation
+
+```bash
+npm install @clonus/react-bindings
+# or
+yarn add @clonus/react-bindings
+# or
+pnpm add @clonus/react-bindings
+```
+
+## Usage
+
+### Basic Setup with ClonusProvider
+
+Wrap your application with the `ClonusProvider` component:
+
+```tsx
+import { ClonusProvider } from '@clonus/react-bindings';
+
+function App() {
+  return (
+    <ClonusProvider 
+      key="your-api-key"
+      user={{
+        email: 'user@example.com',
+        userID: 'user-123',
+        properties: { plan: 'premium' }
+      }}
+      options={{
+        autocapture: { page: true, click: true }
+      }}
+    >
+      <div>Your App Content</div>
+    </ClonusProvider>
+  );
+}
+```
+
+### With Loading Component
+
+You can display a loading component while the client initializes:
+
+```tsx
+<ClonusProvider 
+  key="your-api-key"
+  user={{ email: 'user@example.com' }}
+  loadingComponent={<div>Loading analytics...</div>}
+>
+  <YourApp />
+</ClonusProvider>
+```
+
+### Using the Hook
+
+Use the `useClonusClient` hook to access the client and send events:
+
+```tsx
+import { useClonusClient } from '@clonus/react-bindings';
+
+function MyComponent() {
+  const { client, send, isLoading } = useClonusClient();
+
+  const handleClick = () => {
+    send('Button Clicked', { 
+      buttonName: 'Subscribe',
+      location: 'header' 
+    });
+  };
+
+  if (isLoading) {
+    return <div>Loading...</div>;
+  }
+
+  return (
+    <button onClick={handleClick}>
+      Subscribe
+    </button>
+  );
+}
+```
+
+### Advanced: Using Your Own Client Instance
+
+You can also pass a pre-configured client instance:
+
+```tsx
+import { ClonusClient } from '@clonus/js-client';
+import { ClonusProvider } from '@clonus/react-bindings';
+
+const client = new ClonusClient('your-api-key', {
+  email: 'user@example.com'
+}, {
+  autocapture: { page: true, click: false }
+});
+
+function App() {
+  return (
+    <ClonusProvider client={client}>
+      <YourApp />
+    </ClonusProvider>
+  );
+}
+```
+
+## API Reference
+
+### ClonusProvider
+
+The main provider component that initializes and manages the Clonus client.
+
+#### Props
+
+**Configuration-based (recommended):**
+- `key` (string, required): Your Clonus API key
+- `user` (ClonusUser, required): User information
+  - `email` (string, required): User's email address
+  - `userID` (string, optional): User's unique identifier
+  - `properties` (object, optional): Additional user properties
+- `options` (ClonusOptions, optional): SDK configuration options
+  - `autocapture.page` (boolean): Enable page view tracking (default: true)
+  - `autocapture.click` (boolean): Enable click tracking (default: true)
+  - `flush.interval` (number): Event flush interval in ms (default: 10000)
+  - `flush.threshold` (number): Event batch size threshold (default: 50)
+  - `session.duration` (number): Session duration in ms (default: 1800000)
+  - `session.storage` (boolean): Enable session storage (default: true)
+- `children` (ReactNode): Your application components
+- `loadingComponent` (ReactNode, optional): Component to show while initializing
+
+**Client-based:**
+- `client` (ClonusClient, required): Pre-configured Clonus client instance
+- `children` (ReactNode): Your application components
+- `loadingComponent` (ReactNode, optional): Component to show while initializing
+
+### useClonusClient
+
+Hook to access the Clonus client and send events.
+
+#### Returns
+
+```typescript
+{
+  client: ClonusClient;        // The Clonus client instance
+  send: (event: string, properties?: Record<string, unknown>) => void;  // Send an event
+  isLoading: boolean;          // Whether the client is still initializing
+}
+```
+
+#### Example
+
+```tsx
+const { client, send, isLoading } = useClonusClient();
+
+// Send a custom event
+send('Purchase Completed', { 
+  amount: 99.99, 
+  currency: 'USD',
+  productId: 'prod-123'
+});
+
+// Access the full client
+const userEmail = client.getUser().getEmail();
+```
+
+## TypeScript Support
+
+This package is written in TypeScript and includes full type definitions. All types are exported for your convenience:
+
+```typescript
+import type { 
+  ClonusProviderProps,
+  ClonusContextValue,
+  ClonusUser,
+  ClonusOptions,
+  ClonusClient
+} from '@clonus/react-bindings';
+```
+
+## Best Practices
+
+1. **Place ClonusProvider high in your component tree** - Typically at the root of your application
+2. **Initialize once** - The provider handles client initialization and cleanup automatically
+3. **Use the hook for events** - The `useClonusClient` hook provides optimized event tracking
+4. **Handle loading states** - Use the `isLoading` flag or `loadingComponent` prop for better UX
+
+## License
+
+MIT

package/dist/__tests__/clonus_provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clonus_provider.test.d.ts.map

package/dist/__tests__/clonus_provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clonus_provider.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/clonus_provider.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/setup.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom';
+//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/dist/__tests__/use_clonus_client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use_clonus_client.test.d.ts.map

package/dist/__tests__/use_clonus_client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_clonus_client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/use_clonus_client.test.tsx"],"names":[],"mappings":""}

package/dist/clonus_context.d.ts

@@ -0,0 +1,8 @@
+import { ClonusClient } from '@clonus/js-client';
+export interface ClonusContextValue {
+    readonly renderVersion: number;
+    readonly client: ClonusClient;
+    readonly isLoading: boolean;
+}
+export declare const ClonusContext: import("react").Context<ClonusContextValue>;
+//# sourceMappingURL=clonus_context.d.ts.map

package/dist/clonus_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clonus_context.d.ts","sourceRoot":"","sources":["../src/clonus_context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,6CAIxB,CAAC"}

package/dist/clonus_provider.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';
+type WithClient = {
+    client: ClonusClient;
+};
+type WithConfiguration = {
+    apikey: string;
+    user: ClonusUser;
+    options?: ClonusOptions;
+};
+type ProviderChildrenProps = {
+    children: ReactNode | ReactNode[];
+    loadingComponent?: ReactNode | ReactNode[];
+};
+export type ClonusProviderProps = ProviderChildrenProps & (WithClient | WithConfiguration);
+export declare function ClonusProvider(props: ClonusProviderProps): React.ReactElement;
+export {};
+//# sourceMappingURL=clonus_provider.d.ts.map

package/dist/clonus_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clonus_provider.d.ts","sourceRoot":"","sources":["../src/clonus_provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAgC,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI5E,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAAC;AAE3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAY7E"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { ClonusContext } from './clonus_context';
+export type { ClonusContextValue } from './clonus_context';
+export { ClonusProvider } from './clonus_provider';
+export type { ClonusProviderProps } from './clonus_provider';
+export { useClonusClient } from './use_clonus_client';
+export { useClientAsyncInit } from './use_client_async_init';
+export { NoopClonusClient, isNoopClient } from './noop_clonus_client';
+export * from '@clonus/js-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtE,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),C=require("react/jsx-runtime"),y=require("@clonus/js-client"),s=()=>{},d=()=>Promise.resolve(),h={initializeAsync:d,info:s,warn:s,error:s,shutdown:d,getUser:()=>({getEmail:()=>"",getUserID:()=>{},getProperties:()=>({}),toJSON:()=>({email:""})}),getOptions:()=>({getApiUrl:()=>"",isPageCaptureEnabled:()=>!1,isClickCaptureEnabled:()=>!1,getFlushInterval:()=>0,getFlushThreshold:()=>0,getSessionDuration:()=>0,isSessionStorageEnabled:()=>!1}),getDevice:()=>({getDeviceID:()=>"",getDeviceInfo:()=>({})}),getSession:()=>({getSessionID:()=>"",getSessionInfo:()=>({})}),getEvent:()=>({enqueue:s,flush:d,destroy:s}),getNetwork:()=>({send:d}),getStorage:()=>({get:()=>null,set:s,remove:s}),getLogger:()=>({debug:s,info:s,warn:s,error:s,capture:(e,t,i)=>{try{return t()}catch{return i()}},swallow:(e,t)=>{try{t()}catch{}}}),getBrowser:()=>!1,isNoop:!0};function b(e){return"isNoop"in e&&e.isNoop===!0}const f=o.createContext({renderVersion:0,client:h,isLoading:!0});let g=null;function S(e){if(g)return g;const t=e.options??{};return t.$sdk={version:"0.0.1",library:"react-bindings"},g=new y.ClonusClient(e.apikey,e.user,t),g}function w(e,t,i){const n=o.useMemo(()=>S({apikey:e,user:t,options:i}),[]),[r,u]=o.useState(!0);return o.useMemo(()=>{n.initializeAsync().catch(l=>{console.error("Failed to initialize Clonus client:",l)}).finally(()=>u(!1))},[n]),{client:n,isLoading:r}}function P(e){return"client"in e?(("apikey"in e||"user"in e)&&console.warn("Both client and configuration props (apikey, user) were provided to ClonusProvider. The client prop will be used and the configuration props will be ignored."),C.jsx(x,{...e})):C.jsx(I,{...e})}function I(e){const[t,i]=o.useState(0),n=w(e.apikey,e.user,e.options).client,[r,u]=o.useState(!p(n));m(n,i,u);const l=o.useMemo(()=>({renderVersion:t,client:n,isLoading:r}),[t,n,r]);return C.jsx(f.Provider,{value:l,children:e.loadingComponent==null||!l.isLoading?e.children:e.loadingComponent})}function x(e){const[t,i]=o.useState(0),n=e.client,[r,u]=o.useState(!p(n));m(n,i,u);const l=o.useMemo(()=>({renderVersion:t,client:n,isLoading:r}),[t,n,r]);return C.jsx(f.Provider,{value:l,children:e.loadingComponent==null||!l.isLoading?e.children:e.loadingComponent})}function m(e,t,i){o.useEffect(()=>()=>{e.shutdown().catch(n=>console.error("An error occurred during shutdown",n))},[e,t,i])}function p(e){return"isNoop"in e}function L(){const{client:e,renderVersion:t,isLoading:i}=o.useContext(f),n=o.useMemo(()=>b(e)?(console.warn("Attempting to retrieve a ClonusClient but none was set."),h):e,[e,t]),r=[n,t],u=o.useCallback((a,c)=>n.info(a,c),r),l=o.useCallback((a,c)=>n.warn(a,c),r),v=o.useCallback((a,c)=>n.error(a,c),r);return o.useMemo(()=>({client:n,info:u,warn:l,error:v,isLoading:i}),[n,u,l,v,i])}exports.ClonusContext=f;exports.ClonusProvider=P;exports.NoopClonusClient=h;exports.isNoopClient=b;exports.useClientAsyncInit=w;exports.useClonusClient=L;Object.keys(y).forEach(e=>{e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:()=>y[e]})});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/noop_clonus_client.ts","../src/clonus_context.ts","../src/use_client_async_init.ts","../src/clonus_provider.tsx","../src/use_clonus_client.ts"],"sourcesContent":["import { ClonusClient } from '@clonus/js-client';\n\nconst _noop = (): void => {\n  // noop\n};\n\nconst _noopAsync = (): Promise<void> => Promise.resolve();\n\nexport const NoopClonusClient = {\n  initializeAsync: _noopAsync,\n  info: _noop,\n  warn: _noop,\n  error: _noop,\n  shutdown: _noopAsync,\n  getUser: () => ({\n    getEmail: () => '',\n    getUserID: () => undefined,\n    getProperties: () => ({}),\n    toJSON: () => ({ email: '' }),\n  }),\n  getOptions: () => ({\n    getApiUrl: () => '',\n    isPageCaptureEnabled: () => false,\n    isClickCaptureEnabled: () => false,\n    getFlushInterval: () => 0,\n    getFlushThreshold: () => 0,\n    getSessionDuration: () => 0,\n    isSessionStorageEnabled: () => false,\n  }),\n  getDevice: () => ({\n    getDeviceID: () => '',\n    getDeviceInfo: () => ({}),\n  }),\n  getSession: () => ({\n    getSessionID: () => '',\n    getSessionInfo: () => ({}),\n  }),\n  getEvent: () => ({\n    enqueue: _noop,\n    flush: _noopAsync,\n    destroy: _noop,\n  }),\n  getNetwork: () => ({\n    send: _noopAsync,\n  }),\n  getStorage: () => ({\n    get: () => null,\n    set: _noop,\n    remove: _noop,\n  }),\n  getLogger: () => ({\n    debug: _noop,\n    info: _noop,\n    warn: _noop,\n    error: _noop,\n    capture: <T>(tag: string, task: () => T, recover: () => T) => {\n      try {\n        return task();\n      } catch {\n        return recover();\n      }\n    },\n    swallow: <T>(tag: string, task: () => T) => {\n      try {\n        task();\n      } catch {\n        // swallow\n      }\n    },\n  }),\n  getBrowser: () => false,\n  isNoop: true,\n} as unknown as ClonusClient & { isNoop: true };\n\nexport function isNoopClient(\n  client: ClonusClient | typeof NoopClonusClient\n): client is typeof NoopClonusClient {\n  return 'isNoop' in client && client.isNoop === true;\n}\n","import { createContext } from 'react';\nimport { ClonusClient } from '@clonus/js-client';\nimport { NoopClonusClient } from './noop_clonus_client';\n\nexport interface ClonusContextValue {\n  readonly renderVersion: number;\n  readonly client: ClonusClient;\n  readonly isLoading: boolean;\n}\n\nexport const ClonusContext = createContext<ClonusContextValue>({\n  renderVersion: 0,\n  client: NoopClonusClient,\n  isLoading: true,\n});\n","import { useMemo, useState } from 'react';\nimport { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';\n\ntype FactoryArgs = {\n  apikey: string;\n  user: ClonusUser;\n  options?: ClonusOptions;\n};\n\nlet globalClientInstance: ClonusClient | null = null;\n\nfunction getOrCreateClient(args: FactoryArgs): ClonusClient {\n  if (globalClientInstance) {\n    return globalClientInstance;\n  }\n  const options: ClonusOptions = args.options ?? {};\n  options.$sdk = { version: '0.0.1', library: 'react-bindings' };\n  globalClientInstance = new ClonusClient(args.apikey, args.user, options);\n  return globalClientInstance;\n}\n\nexport function useClientAsyncInit(\n  apikey: string,\n  user: ClonusUser,\n  options?: ClonusOptions\n): { isLoading: boolean; client: ClonusClient } {\n  const client = useMemo(() => getOrCreateClient({ apikey, user, options }), []);\n\n  const [isLoading, setIsLoading] = useState(true);\n\n  useMemo(() => {\n    client\n      .initializeAsync()\n      .catch((err: unknown) => {\n        console.error('Failed to initialize Clonus client:', err);\n      })\n      .finally(() => setIsLoading(false));\n  }, [client]);\n\n  return { client, isLoading };\n}\n","import * as React from 'react';\nimport { ReactNode, useEffect, useMemo, useState } from 'react';\nimport { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';\nimport { ClonusContext } from './clonus_context';\nimport { useClientAsyncInit } from './use_client_async_init';\n\ntype WithClient = {\n  client: ClonusClient;\n};\n\ntype WithConfiguration = {\n  apikey: string;\n  user: ClonusUser;\n  options?: ClonusOptions;\n};\n\ntype ProviderChildrenProps = {\n  children: ReactNode | ReactNode[];\n  loadingComponent?: ReactNode | ReactNode[];\n};\n\nexport type ClonusProviderProps = ProviderChildrenProps & (WithClient | WithConfiguration);\n\nexport function ClonusProvider(props: ClonusProviderProps): React.ReactElement {\n  if (!('client' in props)) {\n    return <ConfigBasedClonusProvider {...props} />;\n  }\n\n  if ('apikey' in props || 'user' in props) {\n    console.warn(\n      'Both client and configuration props (apikey, user) were provided to ClonusProvider. The client prop will be used and the configuration props will be ignored.'\n    );\n  }\n\n  return <ClientBasedClonusProvider {...props} />;\n}\n\nfunction ConfigBasedClonusProvider(\n  props: WithConfiguration & ProviderChildrenProps\n): React.ReactElement {\n  const [renderVersion, setRenderVersion] = useState(0);\n  const client = useClientAsyncInit(props.apikey, props.user, props.options).client;\n  const [isLoading, setIsLoading] = useState(!_isReady(client));\n\n  useClonusClientSetup(client, setRenderVersion, setIsLoading);\n\n  const contextValue = useMemo(\n    () => ({\n      renderVersion,\n      client,\n      isLoading,\n    }),\n    [renderVersion, client, isLoading]\n  );\n\n  return (\n    <ClonusContext.Provider value={contextValue}>\n      {props.loadingComponent == null || !contextValue.isLoading\n        ? props.children\n        : props.loadingComponent}\n    </ClonusContext.Provider>\n  );\n}\n\nfunction ClientBasedClonusProvider(props: WithClient & ProviderChildrenProps): React.ReactElement {\n  const [renderVersion, setRenderVersion] = useState(0);\n  const client = props.client;\n  const [isLoading, setIsLoading] = useState(!_isReady(client));\n\n  useClonusClientSetup(client, setRenderVersion, setIsLoading);\n\n  const contextValue = useMemo(\n    () => ({\n      renderVersion,\n      client,\n      isLoading,\n    }),\n    [renderVersion, client, isLoading]\n  );\n\n  return (\n    <ClonusContext.Provider value={contextValue}>\n      {props.loadingComponent == null || !contextValue.isLoading\n        ? props.children\n        : props.loadingComponent}\n    </ClonusContext.Provider>\n  );\n}\n\nfunction useClonusClientSetup(\n  client: ClonusClient,\n  setRenderVersion: React.Dispatch<React.SetStateAction<number>>,\n  setIsLoading: React.Dispatch<React.SetStateAction<boolean>>\n): void {\n  useEffect(() => {\n    return () => {\n      client\n        .shutdown()\n        .catch((err: unknown) => console.error('An error occurred during shutdown', err));\n    };\n  }, [client, setRenderVersion, setIsLoading]);\n}\n\nfunction _isReady(client: ClonusClient | { isNoop: true }): boolean {\n  if ('isNoop' in client) {\n    return true;\n  }\n\n  return false;\n}\n","import { useCallback, useContext, useMemo } from 'react';\nimport { ClonusClient } from '@clonus/js-client';\nimport { ClonusContext } from './clonus_context';\nimport { NoopClonusClient, isNoopClient } from './noop_clonus_client';\n\ntype HostedFuncs = {\n  info: (message: string, properties?: Record<string, unknown>) => void;\n  warn: (message: string, properties?: Record<string, unknown>) => void;\n  error: (message: string, properties?: Record<string, unknown>) => void;\n};\n\ntype Output = HostedFuncs & {\n  client: ClonusClient;\n  isLoading: boolean;\n};\n\nexport function useClonusClient(): Output {\n  const { client: anyClient, renderVersion, isLoading } = useContext(ClonusContext);\n\n  const client = useMemo(() => {\n    if (isNoopClient(anyClient)) {\n      console.warn('Attempting to retrieve a ClonusClient but none was set.');\n      return NoopClonusClient;\n    }\n\n    return anyClient;\n  }, [anyClient, renderVersion]);\n\n  const deps = [client, renderVersion];\n\n  const info: HostedFuncs['info'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.info(message, properties);\n    },\n    deps\n  );\n\n  const warn: HostedFuncs['warn'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.warn(message, properties);\n    },\n    deps\n  );\n\n  const error: HostedFuncs['error'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.error(message, properties);\n    },\n    deps\n  );\n\n  return useMemo(() => {\n    return {\n      client,\n      info,\n      warn,\n      error,\n      isLoading,\n    };\n  }, [client, info, warn, error, isLoading]);\n}\n"],"names":["_noop","_noopAsync","NoopClonusClient","tag","task","recover","isNoopClient","client","ClonusContext","createContext","globalClientInstance","getOrCreateClient","args","options","ClonusClient","useClientAsyncInit","apikey","user","useMemo","isLoading","setIsLoading","useState","err","ClonusProvider","props","jsx","ClientBasedClonusProvider","ConfigBasedClonusProvider","renderVersion","setRenderVersion","_isReady","useClonusClientSetup","contextValue","useEffect","useClonusClient","anyClient","useContext","deps","info","useCallback","message","properties","warn","error"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,160 @@
+import { createContext as b, useMemo as u, useState as d, useEffect as I, useContext as L, useCallback as h } from "react";
+import { jsx as C } from "react/jsx-runtime";
+import { ClonusClient as S } from "@clonus/js-client";
+export * from "@clonus/js-client";
+const r = () => {
+}, g = () => Promise.resolve(), m = {
+  initializeAsync: g,
+  info: r,
+  warn: r,
+  error: r,
+  shutdown: g,
+  getUser: () => ({
+    getEmail: () => "",
+    getUserID: () => {
+    },
+    getProperties: () => ({}),
+    toJSON: () => ({ email: "" })
+  }),
+  getOptions: () => ({
+    getApiUrl: () => "",
+    isPageCaptureEnabled: () => !1,
+    isClickCaptureEnabled: () => !1,
+    getFlushInterval: () => 0,
+    getFlushThreshold: () => 0,
+    getSessionDuration: () => 0,
+    isSessionStorageEnabled: () => !1
+  }),
+  getDevice: () => ({
+    getDeviceID: () => "",
+    getDeviceInfo: () => ({})
+  }),
+  getSession: () => ({
+    getSessionID: () => "",
+    getSessionInfo: () => ({})
+  }),
+  getEvent: () => ({
+    enqueue: r,
+    flush: g,
+    destroy: r
+  }),
+  getNetwork: () => ({
+    send: g
+  }),
+  getStorage: () => ({
+    get: () => null,
+    set: r,
+    remove: r
+  }),
+  getLogger: () => ({
+    debug: r,
+    info: r,
+    warn: r,
+    error: r,
+    capture: (e, t, o) => {
+      try {
+        return t();
+      } catch {
+        return o();
+      }
+    },
+    swallow: (e, t) => {
+      try {
+        t();
+      } catch {
+      }
+    }
+  }),
+  getBrowser: () => !1,
+  isNoop: !0
+};
+function P(e) {
+  return "isNoop" in e && e.isNoop === !0;
+}
+const v = b({
+  renderVersion: 0,
+  client: m,
+  isLoading: !0
+});
+let f = null;
+function k(e) {
+  if (f)
+    return f;
+  const t = e.options ?? {};
+  return t.$sdk = { version: "0.0.1", library: "react-bindings" }, f = new S(e.apikey, e.user, t), f;
+}
+function x(e, t, o) {
+  const n = u(() => k({ apikey: e, user: t, options: o }), []), [i, l] = d(!0);
+  return u(() => {
+    n.initializeAsync().catch((s) => {
+      console.error("Failed to initialize Clonus client:", s);
+    }).finally(() => l(!1));
+  }, [n]), { client: n, isLoading: i };
+}
+function B(e) {
+  return "client" in e ? (("apikey" in e || "user" in e) && console.warn(
+    "Both client and configuration props (apikey, user) were provided to ClonusProvider. The client prop will be used and the configuration props will be ignored."
+  ), /* @__PURE__ */ C(V, { ...e })) : /* @__PURE__ */ C(N, { ...e });
+}
+function N(e) {
+  const [t, o] = d(0), n = x(e.apikey, e.user, e.options).client, [i, l] = d(!y(n));
+  p(n, o, l);
+  const s = u(
+    () => ({
+      renderVersion: t,
+      client: n,
+      isLoading: i
+    }),
+    [t, n, i]
+  );
+  return /* @__PURE__ */ C(v.Provider, { value: s, children: e.loadingComponent == null || !s.isLoading ? e.children : e.loadingComponent });
+}
+function V(e) {
+  const [t, o] = d(0), n = e.client, [i, l] = d(!y(n));
+  p(n, o, l);
+  const s = u(
+    () => ({
+      renderVersion: t,
+      client: n,
+      isLoading: i
+    }),
+    [t, n, i]
+  );
+  return /* @__PURE__ */ C(v.Provider, { value: s, children: e.loadingComponent == null || !s.isLoading ? e.children : e.loadingComponent });
+}
+function p(e, t, o) {
+  I(() => () => {
+    e.shutdown().catch((n) => console.error("An error occurred during shutdown", n));
+  }, [e, t, o]);
+}
+function y(e) {
+  return "isNoop" in e;
+}
+function z() {
+  const { client: e, renderVersion: t, isLoading: o } = L(v), n = u(() => P(e) ? (console.warn("Attempting to retrieve a ClonusClient but none was set."), m) : e, [e, t]), i = [n, t], l = h(
+    (a, c) => n.info(a, c),
+    i
+  ), s = h(
+    (a, c) => n.warn(a, c),
+    i
+  ), w = h(
+    (a, c) => n.error(a, c),
+    i
+  );
+  return u(() => ({
+    client: n,
+    info: l,
+    warn: s,
+    error: w,
+    isLoading: o
+  }), [n, l, s, w, o]);
+}
+export {
+  v as ClonusContext,
+  B as ClonusProvider,
+  m as NoopClonusClient,
+  P as isNoopClient,
+  x as useClientAsyncInit,
+  z as useClonusClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/noop_clonus_client.ts","../src/clonus_context.ts","../src/use_client_async_init.ts","../src/clonus_provider.tsx","../src/use_clonus_client.ts"],"sourcesContent":["import { ClonusClient } from '@clonus/js-client';\n\nconst _noop = (): void => {\n  // noop\n};\n\nconst _noopAsync = (): Promise<void> => Promise.resolve();\n\nexport const NoopClonusClient = {\n  initializeAsync: _noopAsync,\n  info: _noop,\n  warn: _noop,\n  error: _noop,\n  shutdown: _noopAsync,\n  getUser: () => ({\n    getEmail: () => '',\n    getUserID: () => undefined,\n    getProperties: () => ({}),\n    toJSON: () => ({ email: '' }),\n  }),\n  getOptions: () => ({\n    getApiUrl: () => '',\n    isPageCaptureEnabled: () => false,\n    isClickCaptureEnabled: () => false,\n    getFlushInterval: () => 0,\n    getFlushThreshold: () => 0,\n    getSessionDuration: () => 0,\n    isSessionStorageEnabled: () => false,\n  }),\n  getDevice: () => ({\n    getDeviceID: () => '',\n    getDeviceInfo: () => ({}),\n  }),\n  getSession: () => ({\n    getSessionID: () => '',\n    getSessionInfo: () => ({}),\n  }),\n  getEvent: () => ({\n    enqueue: _noop,\n    flush: _noopAsync,\n    destroy: _noop,\n  }),\n  getNetwork: () => ({\n    send: _noopAsync,\n  }),\n  getStorage: () => ({\n    get: () => null,\n    set: _noop,\n    remove: _noop,\n  }),\n  getLogger: () => ({\n    debug: _noop,\n    info: _noop,\n    warn: _noop,\n    error: _noop,\n    capture: <T>(tag: string, task: () => T, recover: () => T) => {\n      try {\n        return task();\n      } catch {\n        return recover();\n      }\n    },\n    swallow: <T>(tag: string, task: () => T) => {\n      try {\n        task();\n      } catch {\n        // swallow\n      }\n    },\n  }),\n  getBrowser: () => false,\n  isNoop: true,\n} as unknown as ClonusClient & { isNoop: true };\n\nexport function isNoopClient(\n  client: ClonusClient | typeof NoopClonusClient\n): client is typeof NoopClonusClient {\n  return 'isNoop' in client && client.isNoop === true;\n}\n","import { createContext } from 'react';\nimport { ClonusClient } from '@clonus/js-client';\nimport { NoopClonusClient } from './noop_clonus_client';\n\nexport interface ClonusContextValue {\n  readonly renderVersion: number;\n  readonly client: ClonusClient;\n  readonly isLoading: boolean;\n}\n\nexport const ClonusContext = createContext<ClonusContextValue>({\n  renderVersion: 0,\n  client: NoopClonusClient,\n  isLoading: true,\n});\n","import { useMemo, useState } from 'react';\nimport { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';\n\ntype FactoryArgs = {\n  apikey: string;\n  user: ClonusUser;\n  options?: ClonusOptions;\n};\n\nlet globalClientInstance: ClonusClient | null = null;\n\nfunction getOrCreateClient(args: FactoryArgs): ClonusClient {\n  if (globalClientInstance) {\n    return globalClientInstance;\n  }\n  const options: ClonusOptions = args.options ?? {};\n  options.$sdk = { version: '0.0.1', library: 'react-bindings' };\n  globalClientInstance = new ClonusClient(args.apikey, args.user, options);\n  return globalClientInstance;\n}\n\nexport function useClientAsyncInit(\n  apikey: string,\n  user: ClonusUser,\n  options?: ClonusOptions\n): { isLoading: boolean; client: ClonusClient } {\n  const client = useMemo(() => getOrCreateClient({ apikey, user, options }), []);\n\n  const [isLoading, setIsLoading] = useState(true);\n\n  useMemo(() => {\n    client\n      .initializeAsync()\n      .catch((err: unknown) => {\n        console.error('Failed to initialize Clonus client:', err);\n      })\n      .finally(() => setIsLoading(false));\n  }, [client]);\n\n  return { client, isLoading };\n}\n","import * as React from 'react';\nimport { ReactNode, useEffect, useMemo, useState } from 'react';\nimport { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';\nimport { ClonusContext } from './clonus_context';\nimport { useClientAsyncInit } from './use_client_async_init';\n\ntype WithClient = {\n  client: ClonusClient;\n};\n\ntype WithConfiguration = {\n  apikey: string;\n  user: ClonusUser;\n  options?: ClonusOptions;\n};\n\ntype ProviderChildrenProps = {\n  children: ReactNode | ReactNode[];\n  loadingComponent?: ReactNode | ReactNode[];\n};\n\nexport type ClonusProviderProps = ProviderChildrenProps & (WithClient | WithConfiguration);\n\nexport function ClonusProvider(props: ClonusProviderProps): React.ReactElement {\n  if (!('client' in props)) {\n    return <ConfigBasedClonusProvider {...props} />;\n  }\n\n  if ('apikey' in props || 'user' in props) {\n    console.warn(\n      'Both client and configuration props (apikey, user) were provided to ClonusProvider. The client prop will be used and the configuration props will be ignored.'\n    );\n  }\n\n  return <ClientBasedClonusProvider {...props} />;\n}\n\nfunction ConfigBasedClonusProvider(\n  props: WithConfiguration & ProviderChildrenProps\n): React.ReactElement {\n  const [renderVersion, setRenderVersion] = useState(0);\n  const client = useClientAsyncInit(props.apikey, props.user, props.options).client;\n  const [isLoading, setIsLoading] = useState(!_isReady(client));\n\n  useClonusClientSetup(client, setRenderVersion, setIsLoading);\n\n  const contextValue = useMemo(\n    () => ({\n      renderVersion,\n      client,\n      isLoading,\n    }),\n    [renderVersion, client, isLoading]\n  );\n\n  return (\n    <ClonusContext.Provider value={contextValue}>\n      {props.loadingComponent == null || !contextValue.isLoading\n        ? props.children\n        : props.loadingComponent}\n    </ClonusContext.Provider>\n  );\n}\n\nfunction ClientBasedClonusProvider(props: WithClient & ProviderChildrenProps): React.ReactElement {\n  const [renderVersion, setRenderVersion] = useState(0);\n  const client = props.client;\n  const [isLoading, setIsLoading] = useState(!_isReady(client));\n\n  useClonusClientSetup(client, setRenderVersion, setIsLoading);\n\n  const contextValue = useMemo(\n    () => ({\n      renderVersion,\n      client,\n      isLoading,\n    }),\n    [renderVersion, client, isLoading]\n  );\n\n  return (\n    <ClonusContext.Provider value={contextValue}>\n      {props.loadingComponent == null || !contextValue.isLoading\n        ? props.children\n        : props.loadingComponent}\n    </ClonusContext.Provider>\n  );\n}\n\nfunction useClonusClientSetup(\n  client: ClonusClient,\n  setRenderVersion: React.Dispatch<React.SetStateAction<number>>,\n  setIsLoading: React.Dispatch<React.SetStateAction<boolean>>\n): void {\n  useEffect(() => {\n    return () => {\n      client\n        .shutdown()\n        .catch((err: unknown) => console.error('An error occurred during shutdown', err));\n    };\n  }, [client, setRenderVersion, setIsLoading]);\n}\n\nfunction _isReady(client: ClonusClient | { isNoop: true }): boolean {\n  if ('isNoop' in client) {\n    return true;\n  }\n\n  return false;\n}\n","import { useCallback, useContext, useMemo } from 'react';\nimport { ClonusClient } from '@clonus/js-client';\nimport { ClonusContext } from './clonus_context';\nimport { NoopClonusClient, isNoopClient } from './noop_clonus_client';\n\ntype HostedFuncs = {\n  info: (message: string, properties?: Record<string, unknown>) => void;\n  warn: (message: string, properties?: Record<string, unknown>) => void;\n  error: (message: string, properties?: Record<string, unknown>) => void;\n};\n\ntype Output = HostedFuncs & {\n  client: ClonusClient;\n  isLoading: boolean;\n};\n\nexport function useClonusClient(): Output {\n  const { client: anyClient, renderVersion, isLoading } = useContext(ClonusContext);\n\n  const client = useMemo(() => {\n    if (isNoopClient(anyClient)) {\n      console.warn('Attempting to retrieve a ClonusClient but none was set.');\n      return NoopClonusClient;\n    }\n\n    return anyClient;\n  }, [anyClient, renderVersion]);\n\n  const deps = [client, renderVersion];\n\n  const info: HostedFuncs['info'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.info(message, properties);\n    },\n    deps\n  );\n\n  const warn: HostedFuncs['warn'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.warn(message, properties);\n    },\n    deps\n  );\n\n  const error: HostedFuncs['error'] = useCallback(\n    (message: string, properties?: Record<string, unknown>) => {\n      return client.error(message, properties);\n    },\n    deps\n  );\n\n  return useMemo(() => {\n    return {\n      client,\n      info,\n      warn,\n      error,\n      isLoading,\n    };\n  }, [client, info, warn, error, isLoading]);\n}\n"],"names":["_noop","_noopAsync","NoopClonusClient","tag","task","recover","isNoopClient","client","ClonusContext","createContext","globalClientInstance","getOrCreateClient","args","options","ClonusClient","useClientAsyncInit","apikey","user","useMemo","isLoading","setIsLoading","useState","err","ClonusProvider","props","jsx","ClientBasedClonusProvider","ConfigBasedClonusProvider","renderVersion","setRenderVersion","_isReady","useClonusClientSetup","contextValue","useEffect","useClonusClient","anyClient","useContext","deps","info","useCallback","message","properties","warn","error"],"mappings":"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"}

package/dist/noop_clonus_client.d.ts

@@ -0,0 +1,6 @@
+import { ClonusClient } from '@clonus/js-client';
+export declare const NoopClonusClient: ClonusClient & {
+    isNoop: true;
+};
+export declare function isNoopClient(client: ClonusClient | typeof NoopClonusClient): client is typeof NoopClonusClient;
+//# sourceMappingURL=noop_clonus_client.d.ts.map

package/dist/noop_clonus_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop_clonus_client.d.ts","sourceRoot":"","sources":["../src/noop_clonus_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQjD,eAAO,MAAM,gBAAgB,EAgEb,YAAY,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAEhD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,GAAG,OAAO,gBAAgB,GAC7C,MAAM,IAAI,OAAO,gBAAgB,CAEnC"}

package/dist/use_client_async_init.d.ts

@@ -0,0 +1,6 @@
+import { ClonusClient, ClonusUser, ClonusOptions } from '@clonus/js-client';
+export declare function useClientAsyncInit(apikey: string, user: ClonusUser, options?: ClonusOptions): {
+    isLoading: boolean;
+    client: ClonusClient;
+};
+//# sourceMappingURL=use_client_async_init.d.ts.map

package/dist/use_client_async_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_client_async_init.d.ts","sourceRoot":"","sources":["../src/use_client_async_init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoB5E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAe9C"}

package/dist/use_clonus_client.d.ts

@@ -0,0 +1,13 @@
+import { ClonusClient } from '@clonus/js-client';
+type HostedFuncs = {
+    info: (message: string, properties?: Record<string, unknown>) => void;
+    warn: (message: string, properties?: Record<string, unknown>) => void;
+    error: (message: string, properties?: Record<string, unknown>) => void;
+};
+type Output = HostedFuncs & {
+    client: ClonusClient;
+    isLoading: boolean;
+};
+export declare function useClonusClient(): Output;
+export {};
+//# sourceMappingURL=use_clonus_client.d.ts.map

package/dist/use_clonus_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_clonus_client.d.ts","sourceRoot":"","sources":["../src/use_clonus_client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACxE,CAAC;AAEF,KAAK,MAAM,GAAG,WAAW,GAAG;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,IAAI,MAAM,CA4CxC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@clonus/react-bindings",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "React bindings for Clonus Analytics SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clonus/js-client": "2.0.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.1.0",
+    "@testing-library/jest-dom": "^6.1.5",
+    "@testing-library/user-event": "^14.5.1",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.0.6",
+    "@vitejs/plugin-react": "^4.2.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "jsdom": "^23.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly --declaration --declarationMap",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint 'src/**/*.{ts,tsx}'",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix",
+    "type-check": "tsc --noEmit"
+  }
+}