@centive/aria-sdk 0.3.0 → 0.4.0

package/README.md

@@ -54,49 +54,71 @@ npm install react@^18.0.0 react-dom@^18.0.0
 
 ## 🚀 Quick Start
 
-### 1. Wrap Your App with AriaProvider
+### 1. Simple Integration (Recommended)
+
+The SDK provides an all-in-one container that handles WebSocket connection, state management, and the UI. Just import and drop it in! By default, this includes both the floating trigger button and the assistant widget.
 
 ```tsx
-import { AriaProvider, AriaAssistant, AriaTriggerButton } from '@centive/aria-sdk';
+import { Aria } from '@centive/aria-sdk';
 import '@centive/aria-sdk/styles.css';
 
 function App() {
-  // Note: Persona configuration is now handled by the backend
-  // The backend determines which persona to display based on user context
   const config = {
     websocketUrl: 'ws://localhost:8000/ws',
-    userId: 'user_123', // Required for backend persona selection & message accumulation
+    userId: 'user_123',
     theme: 'light', // or 'dark'
-    
-    // WebSocket event callbacks
-    onWebSocketEvent: (event) => {
-      console.log('Incoming WebSocket event:', event);
-    },
-    onError: (error) => console.error('Error:', error),
-    onSessionReady: () => console.log('Session ready!'),
-    onConnectionStateChange: (connected) => console.log('Connected:', connected),
-    
-    // Message accumulation callbacks
-    onMessageHistoryAck: (messageCount) => {
-      console.log(`Message history saved: ${messageCount} messages`);
-    },
-    onSessionEndAck: (savedCount) => {
-      console.log(`Session ended: ${savedCount} messages saved`);
-    },
-    onSessionEndError: (error, errorType) => {
-      console.error(`Session end failed: ${errorType} - ${error}`);
-    },
+  };
+
+  return (
+    // This automatically renders the Trigger Button and Assistant Widget
+    <Aria config={config}>
+      <YourApp />
+    </Aria>
+  );
+}
+```
+
+### 2. Advanced Integration (Manual Placement)
+
+If you need full control over where components are rendered, you can disable the automatic rendering and place the component yourself:
+
+```tsx
+import { AriaProvider, AriaAssistant } from '@centive/aria-sdk';
+
+function App() {
+  const config = {
+    websocketUrl: 'ws://localhost:8000/ws',
+    userId: 'user_123',
+    showAssistant: false, // Disable automatic rendering
   };
 
   return (
     <AriaProvider config={config}>
       <YourApp />
       
-      {/* Floating trigger button */}
-      <AriaTriggerButton showAvatar={true} />
-      
-      {/* Assistant widget */}
-      <AriaAssistant />
+      {/* AriaAssistant includes both the trigger button and the widget */}
+      <AriaAssistant 
+        showTrigger={true}      // Show floating trigger button
+        showAvatar={true}       // Show avatar in trigger
+        triggerLabel="Chat"     // Custom button label
+      />
+    </AriaProvider>
+  );
+}
+```
+
+### 3. Trigger Button Only (No Auto-Popup)
+
+If you only want the trigger button without the automatic assistant:
+
+```tsx
+import { AriaProvider, AriaTriggerButton } from '@centive/aria-sdk';
+
+function App() {
+  return (
+    <AriaProvider config={config}>
+      <YourApp />
+      <AriaTriggerButton showAvatar={true} label="Help" />
     </AriaProvider>
   );
 }
@@ -177,10 +199,14 @@ Main provider component that wraps your application.
 
 ### AriaAssistant
 
-Main assistant widget component.
+Complete assistant component that includes both the floating trigger button and the assistant widget.
 
 ```tsx
-<AriaAssistant />
+<AriaAssistant 
+  showTrigger={true}      // Show floating trigger button (default: true)
+  showAvatar={true}       // Show avatar in trigger button (default: true)
+  triggerLabel="Chat"     // Optional custom label for trigger button
+/>
 ```
 
 ### AriaTriggerButton
@@ -248,6 +274,10 @@ interface AriaSDKConfig {
   onMessageStreamAck?: () => void;
   onSessionEndAck?: (savedCount: number) => void;
   onSessionEndError?: (error: string, errorType: string) => void;
+  
+  // Rendering options
+  showFloatingButton?: boolean;      // Show the default floating button (default: true)
+  showAssistant?: boolean;           // Show the assistant widget (default: true)
 }
 ```
 

package/dist/components/AriaAssistant.d.ts

@@ -1,3 +1,12 @@
 import React from 'react';
-export declare const AriaAssistant: React.FC;
+interface AriaAssistantProps {
+    /** Show the floating trigger button (default: true) */
+    showTrigger?: boolean;
+    /** Show avatar in trigger button (default: true) */
+    showAvatar?: boolean;
+    /** Custom label for trigger button */
+    triggerLabel?: string;
+}
+export declare const AriaAssistant: React.FC<AriaAssistantProps>;
+export {};
 //# sourceMappingURL=AriaAssistant.d.ts.map

package/dist/components/AriaAssistant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AriaAssistant.d.ts","sourceRoot":"","sources":["../../src/components/AriaAssistant.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EA6CjC,CAAC"}
+{"version":3,"file":"AriaAssistant.d.ts","sourceRoot":"","sources":["../../src/components/AriaAssistant.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,UAAU,kBAAkB;IAC1B,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAwDtD,CAAC"}

package/dist/components/AriaTriggerButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AriaTriggerButton.d.ts","sourceRoot":"","sources":["../../src/components/AriaTriggerButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1D,UAAU,sBAAuB,SAAQ,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAgI9D,CAAC"}
+{"version":3,"file":"AriaTriggerButton.d.ts","sourceRoot":"","sources":["../../src/components/AriaTriggerButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1D,UAAU,sBAAuB,SAAQ,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA2I9D,CAAC"}

package/dist/context/AriaProvider.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { AriaSDKConfig } from '@/types';
 interface AriaProviderProps {
     config: AriaSDKConfig;
-    children: React.ReactNode;
+    children?: React.ReactNode;
 }
 export declare const AriaProvider: React.FC<AriaProviderProps>;
 export {};

package/dist/context/AriaProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AriaProvider.d.ts","sourceRoot":"","sources":["../../src/context/AriaProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAmBxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C,UAAU,iBAAiB;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAgGD,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAugBpD,CAAC"}
+{"version":3,"file":"AriaProvider.d.ts","sourceRoot":"","sources":["../../src/context/AriaProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAmBxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,UAAU,iBAAiB;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAgGD,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAkhBpD,CAAC"}

package/dist/{index-SOt2llBN.js → index-BhEwL6TA.js}

@@ -1,5 +1,5 @@
-import { A as n } from "./index-BP2VXIUE.js";
-import { d as i, b as C, a as d, C as l, c as m, D as A, E as c, I as g, M as u, S as E } from "./index-BP2VXIUE.js";
+import { A as n } from "./index-Bwp7d2Nw.js";
+import { d as i, b as C, a as d, C as l, c as m, D as A, E as c, I as g, M as u, S as E } from "./index-Bwp7d2Nw.js";
 const t = (e, a) => new n(e, void 0, a);
 export {
   i as AgentAudioInputStream,
@@ -14,4 +14,4 @@ export {
   E as SignalMessageAction,
   t as createClient
 };
-//# sourceMappingURL=index-SOt2llBN.js.map
+//# sourceMappingURL=index-BhEwL6TA.js.map

package/dist/{index-SOt2llBN.js.map → index-BhEwL6TA.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index-SOt2llBN.js","sources":["../node_modules/@anam-ai/js-sdk/dist/module/index.js"],"sourcesContent":["import AnamClient from './AnamClient';\nimport { ClientError, ErrorCode } from './lib/ClientError';\n/**\n * Create a new Anam client.\n * @param sessionToken - A session token can be obtained from the Anam API.\n * @param personaConfig - The persona configuration to use.\n * @param options - Additional options.\n * @returns A new Anam client instance.\n */\nconst createClient = (sessionToken, options) => {\n    return new AnamClient(sessionToken, undefined, options);\n};\n/**\n * Create a new Anam client with an API key instead of a session token.\n * This method is unsafe for production environments because it requires exposing your API key to the client side.\n * Only use this method for local testing.\n * @param apiKey - Your Anam API key.\n * @param personaConfig - The persona configuration to use.\n * @param options - Additional options.\n * @returns A new Anam client instance.\n */\nconst unsafe_createClientWithApiKey = (apiKey, personaConfig, options) => {\n    return new AnamClient(undefined, personaConfig, Object.assign(Object.assign({}, options), { apiKey }));\n};\nexport { createClient, unsafe_createClientWithApiKey, ClientError, ErrorCode };\nexport * from './types';\n//# sourceMappingURL=index.js.map"],"names":["createClient","sessionToken","options","AnamClient"],"mappings":";;AASK,MAACA,IAAe,CAACC,GAAcC,MACzB,IAAIC,EAAWF,GAAc,QAAWC,CAAO;","x_google_ignoreList":[0]}
+{"version":3,"file":"index-BhEwL6TA.js","sources":["../node_modules/@anam-ai/js-sdk/dist/module/index.js"],"sourcesContent":["import AnamClient from './AnamClient';\nimport { ClientError, ErrorCode } from './lib/ClientError';\n/**\n * Create a new Anam client.\n * @param sessionToken - A session token can be obtained from the Anam API.\n * @param personaConfig - The persona configuration to use.\n * @param options - Additional options.\n * @returns A new Anam client instance.\n */\nconst createClient = (sessionToken, options) => {\n    return new AnamClient(sessionToken, undefined, options);\n};\n/**\n * Create a new Anam client with an API key instead of a session token.\n * This method is unsafe for production environments because it requires exposing your API key to the client side.\n * Only use this method for local testing.\n * @param apiKey - Your Anam API key.\n * @param personaConfig - The persona configuration to use.\n * @param options - Additional options.\n * @returns A new Anam client instance.\n */\nconst unsafe_createClientWithApiKey = (apiKey, personaConfig, options) => {\n    return new AnamClient(undefined, personaConfig, Object.assign(Object.assign({}, options), { apiKey }));\n};\nexport { createClient, unsafe_createClientWithApiKey, ClientError, ErrorCode };\nexport * from './types';\n//# sourceMappingURL=index.js.map"],"names":["createClient","sessionToken","options","AnamClient"],"mappings":";;AASK,MAACA,IAAe,CAACC,GAAcC,MACzB,IAAIC,EAAWF,GAAc,QAAWC,CAAO;","x_google_ignoreList":[0]}