@gentour/dedge-support-widget 0.1.0

package/README.md

@@ -0,0 +1,163 @@
+# D-EDGE Support Agent Widget
+
+Widget SDK pour intégrer l'assistant support D-EDGE sur l'extranet Availpro.
+
+## Installation
+
+### Via CDN (Production)
+
+```html
+<script src="https://dedgesupport.gentour.ai/widget.js"></script>
+<script>
+  DEdgeSupportWidget.init({
+    frontendUrl: 'https://dedgesupport.gentour.ai',
+    credentials: 'xxxEncodedBase64xxx',  // Fourni par Gentour
+  });
+</script>
+```
+
+### Via NPM
+
+```bash
+npm install @dedge/support-agent-widget
+```
+
+## Configuration
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `frontendUrl` | string | `https://dedgesupport.gentour.ai` | URL du frontend chat |
+| `apiUrl` | string | `frontendUrl + /api` | URL de l'API |
+| `credentials` | string | - | Credentials Base64 `btoa("email:password")` |
+| `mode` | `"sidebar"` \| `"popup"` \| `"inline"` | `"sidebar"` | Mode d'affichage |
+| `position` | `"right"` \| `"left"` | `"right"` | Position du widget |
+| `theme` | `"light"` \| `"dark"` \| `"auto"` | `"light"` | Thème |
+| `buttonText` | string | `"Need help?"` | Texte du bouton |
+| `primaryColor` | string | `"#0066CC"` | Couleur principale |
+
+### Callbacks
+
+```javascript
+DEdgeSupportWidget.init({
+  // ...
+  onOpen: () => console.log('Widget opened'),
+  onClose: () => console.log('Widget closed'),
+  onAuthStateChange: (user) => console.log('Auth:', user),
+  onContextExtracted: (ctx) => console.log('D-EDGE context:', ctx),
+});
+```
+
+## D-EDGE Context
+
+Le widget extrait automatiquement le contexte utilisateur depuis `dataLayer.dEdgeContext`:
+
+```javascript
+{
+  userName: "Clemence DOUAY",
+  userEmail: "clemence.douay@availpro.com",
+  userId: 14695,
+  hotelId: 13673,
+  groupId: 9791
+}
+```
+
+Ce contexte est envoyé au backend pour le tracking/analytics dans Langfuse.
+
+## Development
+
+### Build
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+SUPABASE_URL=https://xxx.supabase.co \
+SUPABASE_ANON_KEY=eyJ... \
+npm run build
+
+# Watch mode
+npm run dev
+
+# Serve locally
+npm run serve  # Serves on http://localhost:3001
+```
+
+### Test sur l'extranet Availpro
+
+Injecter dans la console navigateur:
+
+```javascript
+const script = document.createElement('script');
+script.src = 'http://localhost:3001/widget.js';
+document.head.appendChild(script);
+
+script.onload = () => {
+  DEdgeSupportWidget.init({
+    frontendUrl: 'http://localhost:3000',
+    credentials: btoa('widget@dedge.gentour.ai:yourPassword'),
+  });
+};
+```
+
+## API
+
+### Instance Methods
+
+```javascript
+const widget = DEdgeSupportWidget.init({ ... });
+
+widget.open();           // Ouvrir le widget
+widget.close();          // Fermer le widget
+widget.toggle();         // Toggle open/close
+widget.isOpen();         // Vérifier si ouvert
+widget.getContext();     // Obtenir le contexte D-EDGE
+widget.destroy();        // Détruire le widget
+```
+
+## Setup: Supabase Technical User
+
+The widget requires a technical Supabase user for authentication. Follow these steps:
+
+### 1. Create the user in Supabase
+
+Go to your Supabase Dashboard > Authentication > Users, and create a new user:
+
+- **Email:** `widget@dedge.gentour.ai` (or your preferred email)
+- **Password:** Generate a strong password
+
+### 2. Add agent permissions (if not using default)
+
+If `dedge-support-agent` is not in the `DEFAULT_ALLOWED_AGENTS` list in auth-proxy, add it to the user's `app_metadata`:
+
+```sql
+-- Run in Supabase SQL Editor
+UPDATE auth.users 
+SET raw_app_meta_data = raw_app_meta_data || '{"allowed_agents": ["dedge-support-agent"]}'::jsonb
+WHERE email = 'widget@dedge.gentour.ai';
+```
+
+### 3. Configure the widget
+
+Encode the credentials and use them in the widget initialization:
+
+```javascript
+// Generate credentials (do this once, securely)
+const credentials = btoa('widget@dedge.gentour.ai:yourPassword');
+console.log('Credentials:', credentials);
+
+// Use in widget
+DEdgeSupportWidget.init({
+  frontendUrl: 'https://dedgesupport.gentour.ai',
+  credentials: credentials,
+});
+```
+
+### Security Notes
+
+- The Base64 encoding is for obfuscation, not encryption
+- If credentials are compromised, change the password and rebuild/redeploy the widget
+- The worst-case scenario is someone consuming LLM tokens
+- Consider rate limiting at the API level for additional protection

package/dist/auth.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Authentication module for the widget
+ * Handles Supabase authentication within the widget
+ */
+import type { User, Session } from "@supabase/supabase-js";
+export interface AuthState {
+    user: User | null;
+    session: Session | null;
+    loading: boolean;
+}
+export declare class WidgetAuth {
+    private supabase;
+    private authState;
+    private listeners;
+    constructor(url: string, anonKey: string);
+    private initialize;
+    private updateState;
+    private notifyListeners;
+    subscribe(listener: (state: AuthState) => void, skipInitialCall?: boolean): () => void;
+    getState(): AuthState;
+    getAccessToken(): string | null;
+    signIn(email: string, password: string): Promise<{
+        user: User;
+        session: Session;
+        weakPassword?: import("@supabase/supabase-js").WeakPassword;
+    }>;
+    signOut(): Promise<void>;
+}
+/**
+ * Decode Base64 credentials
+ * @param credentials Base64-encoded "email:password" string
+ * @returns Object with email and password, or null if invalid
+ */
+export declare function decodeCredentials(credentials: string): {
+    email: string;
+    password: string;
+} | null;

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build-time configuration for the widget
+ * These values are injected at build time from environment variables
+ *
+ * Usage: Set SUPABASE_URL and SUPABASE_ANON_KEY environment variables before building
+ * Example: SUPABASE_URL=https://xxx.supabase.co SUPABASE_ANON_KEY=eyJ... npm run build
+ */
+/**
+ * Get Supabase configuration if available
+ * Returns undefined if not configured (auth will be disabled)
+ */
+export declare function getSupabaseConfig(): {
+    url: string;
+    anonKey: string;
+} | undefined;

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Types for the D-EDGE Support Agent Widget SDK
+ */
+export type WidgetMode = "sidebar" | "popup" | "inline";
+export type WidgetPosition = "right" | "left";
+export type WidgetTheme = "light" | "dark" | "auto";
+/**
+ * D-EDGE context extracted from the Availpro extranet dataLayer
+ * Used for tracking/analytics purposes (NOT for authentication)
+ */
+export interface DEdgeContext {
+    /**
+     * User's display name from Availpro
+     */
+    userName: string;
+    /**
+     * User's email from Availpro
+     */
+    userEmail: string;
+    /**
+     * User's ID in Availpro system
+     */
+    userId: number;
+    /**
+     * Hotel ID the user is currently viewing
+     */
+    hotelId: number;
+    /**
+     * Group ID the hotel belongs to
+     */
+    groupId: number;
+}
+/**
+ * Widget initialization options
+ */
+export interface DEdgeSupportWidgetOptions {
+    /**
+     * URL of the Next.js chat frontend where the /widget page is hosted.
+     * @example "https://dedgesupport.gentour.ai"
+     */
+    frontendUrl?: string;
+    /**
+     * URL of the Next.js API proxy (frontendUrl + /api).
+     * If not provided, defaults to frontendUrl + "/api".
+     * @example "https://dedgesupport.gentour.ai/api"
+     */
+    apiUrl?: string;
+    /**
+     * ID of the LangGraph assistant.
+     * @default "dedge-support-agent"
+     */
+    assistantId?: string;
+    /**
+     * Base64-encoded credentials for Supabase authentication.
+     * Format: btoa("email:password")
+     * @example btoa("widget@dedge.gentour.ai:secretPassword")
+     */
+    credentials?: string;
+    /**
+     * Widget display mode.
+     * @default "sidebar"
+     */
+    mode?: WidgetMode;
+    /**
+     * Widget position (for sidebar mode).
+     * @default "right"
+     */
+    position?: WidgetPosition;
+    /**
+     * Widget theme.
+     * @default "light"
+     */
+    theme?: WidgetTheme;
+    /**
+     * Button text.
+     * @default "Need help?"
+     */
+    buttonText?: string;
+    /**
+     * Primary color (hex).
+     * @default "#0066CC" (D-EDGE blue)
+     */
+    primaryColor?: string;
+    /**
+     * Container ID (for inline mode).
+     */
+    containerId?: string;
+    /**
+     * Widget width.
+     * @default "50vw" for sidebar, "400px" for popup
+     */
+    width?: string;
+    /**
+     * Widget height.
+     * @default "100vh" for sidebar
+     */
+    height?: string;
+    /**
+     * Callbacks
+     */
+    onOpen?: () => void;
+    onClose?: () => void;
+    onAuthStateChange?: (user: {
+        id: string;
+        email?: string;
+    } | null) => void;
+    onContextExtracted?: (context: DEdgeContext | null) => void;
+}
+/**
+ * Widget instance interface
+ */
+export interface DEdgeSupportWidgetInstance {
+    /**
+     * Open the widget.
+     */
+    open: () => void;
+    /**
+     * Close the widget.
+     */
+    close: () => void;
+    /**
+     * Toggle open/close.
+     */
+    toggle: () => void;
+    /**
+     * Check if the widget is open.
+     */
+    isOpen: () => boolean;
+    /**
+     * Get the extracted D-EDGE context.
+     */
+    getContext: () => DEdgeContext | null;
+    /**
+     * Update configuration.
+     */
+    updateConfig: (config: Partial<DEdgeSupportWidgetOptions>) => void;
+    /**
+     * Destroy the widget.
+     */
+    destroy: () => void;
+}

package/dist/widget.d.ts

@@ -0,0 +1,10 @@
+/**
+ * D-EDGE Support Agent Widget SDK
+ */
+import type { DEdgeSupportWidgetInstance, DEdgeSupportWidgetOptions, DEdgeContext } from "./types";
+/**
+ * Main initialization function for the widget.
+ */
+declare function initDEdgeSupportWidget(config: DEdgeSupportWidgetOptions): DEdgeSupportWidgetInstance;
+export { initDEdgeSupportWidget };
+export type { DEdgeContext };