guideai-app 0.1.8 → 0.2.0

package/dist/utils/webrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.js","sourceRoot":"","sources":["../../src/utils/webrtc.ts"],"names":[],"mappings":"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"}

package/obfuscate.js

@@ -0,0 +1,40 @@
+const fs = require('fs');
+const path = require('path');
+const JavaScriptObfuscator = require('javascript-obfuscator');
+
+// Files to obfuscate
+const files = [
+  'dist/index.js',
+  'dist/index.esm.js'
+];
+
+// Load obfuscator config
+const config = JSON.parse(fs.readFileSync(path.resolve(__dirname, 'obfuscator.json'), 'utf8'));
+
+// Process each file
+
+files.forEach(file => {
+  const filePath = path.resolve(__dirname, file);
+  
+  try {
+    // Check if file exists
+    if (!fs.existsSync(filePath)) {
+      console.warn(`Warning: ${file} does not exist, skipping obfuscation.`);
+      return;
+    }
+    
+    
+    // Read the file
+    const code = fs.readFileSync(filePath, 'utf8');
+    
+    // Obfuscate the code
+    const obfuscationResult = JavaScriptObfuscator.obfuscate(code, config);
+    
+    // Write the obfuscated code back to the file
+    fs.writeFileSync(filePath, obfuscationResult.getObfuscatedCode());
+    
+  } catch (error) {
+    console.error(`Error obfuscating ${file}:`, error);
+    process.exit(1);
+  }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guideai-app",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "AI-powered guide component for React applications",
   "main": "dist/GuideAI.js",
   "types": "dist/GuideAI.d.ts",

package/rollup.config.js

@@ -0,0 +1,34 @@
+import commonjs from '@rollup/plugin-commonjs';
+import resolve from '@rollup/plugin-node-resolve';
+import typescript from '@rollup/plugin-typescript';
+import { terser } from 'rollup-plugin-terser';
+import peerDepsExternal from 'rollup-plugin-peer-deps-external';
+
+export default {
+  input: 'src/index.ts',
+  output: [
+    {
+      file: 'dist/index.js',
+      format: 'cjs',
+      sourcemap: true,
+      exports: 'named'
+    },
+    {
+      file: 'dist/index.esm.js',
+      format: 'esm',
+      sourcemap: true,
+      exports: 'named'
+    },
+  ],
+  plugins: [
+    peerDepsExternal(),
+    resolve(),
+    commonjs(),
+    typescript({
+      tsconfig: './tsconfig.json',
+      exclude: ['**/__tests__/**'],
+    }),
+    terser(),
+  ],
+  external: ['react', 'react-dom', 'openai'],
+}; 

package/structure.md

@@ -0,0 +1,128 @@
+# GuideAI Package Structure
+
+## Directory Structure
+
+```
+guide-ai-package/src/
+├── GuideAI.tsx                 # Main component
+├── index.ts                    # Package entry point
+├── components/                 # React components
+│   └── Styles.tsx              # Styling for the component
+├── hooks/                      # React hooks
+│   ├── useConversation.ts      # Conversation management
+│   └── useRecording.ts         # Audio recording and WebRTC
+├── types/                      # TypeScript type definitions
+│   └── index.ts                # Type definitions
+└── utils/                      # Utility functions
+    ├── api-services.ts         # API related functions
+    ├── dom-interaction.ts      # DOM manipulation utilities
+    ├── react-hooks.ts          # React hooks utilities
+    ├── storage.ts              # Local storage utilities
+    └── webrtc.ts               # WebRTC related utilities
+```
+
+## File Descriptions
+
+### Main Files
+
+#### `GuideAI.tsx`
+The main component exported by the package that provides the user interface for audio interactions.
+
+**Functions & Components:**
+- `GuideAI(props: GuideAIProps)`: Main component that renders the UI
+  - Sets up conversation management
+  - Initializes audio recording
+  - Handles user interactions
+
+#### `index.ts`
+Entry point for the package, exports the GuideAI component and types.
+
+**Exports:**
+- `GuideAI`
+- `GuideAIProps` (type)
+
+### Components
+
+#### `components/Styles.tsx`
+Contains the CSS styling for the GuideAI component.
+
+**Functions & Components:**
+- `Styles()`: Component that injects CSS styles into the page
+
+### Hooks
+
+#### `hooks/useConversation.ts`
+Custom hook for managing conversation state and interaction with the API.
+
+**Functions:**
+- `useConversation(organizationKey, onError)`: Main hook function
+  - `storeConversationItem(item)`: Stores a conversation item
+  - `initializeConversation()`: Creates or restores a conversation
+  - `logMessageToConversation(content, sender)`: Logs a message to the conversation
+  - `addConversationHistory(sendMessageFn)`: Adds conversation history to a new session
+  - `isConversationStale()`: Checks if conversation is more than 15 minutes old
+
+#### `hooks/useRecording.ts`
+Custom hook for managing audio recording, WebRTC connections, and handling responses.
+
+**Functions:**
+- `useRecording(organizationKey, onError, logMessageFn, addConversationHistoryFn, storeConversationItemFn, isAddingHistoryContextRef)`: Main hook function
+  - `sendWebRTCMessage(message)`: Sends a message through WebRTC
+  - `cleanupWebRTC()`: Cleans up WebRTC connections and media streams
+  - `handleWebRTCMessage(message)`: Handles incoming WebRTC messages
+  - `startRecording()`: Starts audio recording
+  - `stopRecording()`: Stops audio recording
+  - `toggleRecording()`: Toggles recording state
+
+### Types
+
+#### `types/index.ts`
+Contains TypeScript type definitions used throughout the package.
+
+**Types:**
+- `ConversationItem`: Represents an item in the conversation
+- `RecordingStatus`: Status of the recording ('idle' | 'recording' | 'processing' | 'playing' | 'initializing')
+- `GuideAIProps`: Props for the GuideAI component
+
+### Utils
+
+#### `utils/api-services.ts`
+Functions for interacting with external APIs.
+
+**Functions:**
+- `createNewConversation(organizationKey)`: Creates a new conversation
+- `logMessage(conversationId, content, sender)`: Logs a message to the conversation
+- `fetchEphemeralToken(organizationKey)`: Fetches an ephemeral token for WebRTC
+- `geminiFlash(prompt)`: Makes a call to the Gemini API
+
+#### `utils/dom-interaction.ts`
+Utilities for interacting with the DOM.
+
+**Functions:**
+- `highlightElement(selector, logMessageFn)`: Highlights an element on the page
+- DOM traversal and interaction functions
+
+#### `utils/react-hooks.ts`
+Utilities for React hooks to avoid duplicate React instances.
+
+**Functions:**
+- `getReactHooks()`: Returns React hooks from the host application or fall back to local ones
+
+#### `utils/storage.ts`
+Local storage utility functions.
+
+**Constants:**
+- `STORAGE_PREFIX`: Prefix for storage keys
+- `STORAGE_KEYS`: Object containing all storage keys
+
+**Functions:**
+- `saveToStorage(key, value)`: Saves a value to localStorage
+- `getFromStorage(key, defaultValue)`: Gets a value from localStorage
+
+#### `utils/webrtc.ts`
+WebRTC related utilities for audio streaming.
+
+**Functions:**
+- `initializeWebRTC(audioStream, token, audioElementRef, peerConnectionRef, dataChannelRef, handleMessageCallback)`: Sets up WebRTC connection
+- `sendMessage(dataChannel, message)`: Sends a message through the data channel
+- `orderConversationItems(items)`: Orders conversation items for replay 

package/todo.md

@@ -0,0 +1,2 @@
+output_audio_buffer.completed - find new way to track end of speech
+use workflows from site, pull selectors instead of using from prompt