@lynxflow/seo-engine 1.0.0 → 1.2.0

package/connectors/wordpress/lynxseo-connector.php

@@ -1,75 +1,318 @@
 <?php
 /**
- * Plugin Name: LynxFlow SEO Engine Connector
+ * Plugin Name: LynxFlow SEO Engine (Moteur Programmatique & Blog Autonome)
  * Plugin URI: https://lynxintel.io/seo
- * Description: Connecte votre site WordPress au SDK LynxFlow SEO pour générer des milliers de landing pages ultra-rapides (< 0.05ms) avec balisage 4.9/5 étoiles et optimisation GEO.
- * Version: 1.0.0
+ * Description: Moteur pSEO, AEO et Blog 100% autonome pour WordPress. Connexion en 1 clic via Better Auth. Génère et sert instantanément les 8 Matrices Programmatiques chez vous (< 0.05ms) avec sitemap XML automatique et 0% de charge sur votre base MySQL.
+ * Version: 2.2.0
  * Author: LynxFlow Technologies
  * License: Proprietary
  */
 
 if (!defined('ABSPATH')) exit;
 
-class LynxSeoWordPressConnector {
-    private $license_key = 'lynx_live_sk_votre_cle_ici'; // Remplacez par votre clé de licence
-    private $api_endpoint = 'https://lynxintel.io/api/v1/render-page'; // Ou votre instance LynxSEO
+class LynxSeoWordPressEngine {
+    private $option_name = 'lynxflow_seo_settings';
+    private $oauth_auth_url = 'https://lynxintel.io/api/auth/oauth/authorize';
 
     public function __construct() {
         add_action('init', array($this, 'register_rewrite_rules'));
-        add_action('template_redirect', array($this, 'handle_solution_page'));
+        add_action('template_redirect', array($this, 'handle_programmatic_page'));
+        add_action('admin_menu', array($this, 'add_admin_menu'));
+        add_action('admin_init', array($this, 'register_settings'));
+        add_action('admin_init', array($this, 'handle_oauth_callback'));
     }
 
     public function register_rewrite_rules() {
-        add_rewrite_rule(
-            '^solutions/([^/]+)/([^/]+)/([^/]+)/?',
-            'index.php?lynx_service=$matches[1]&lynx_country=$matches[2]&lynx_city=$matches[3]',
-            'top'
+        // Sitemap XML dynamique autonome (100% White-Label sur le site client)
+        add_rewrite_rule('^sitemap-solutions\.xml$', 'index.php?lynx_sitemap=1', 'top');
+        add_rewrite_rule('^sitemap-programmatic\.xml$', 'index.php?lynx_sitemap=1', 'top');
+
+        // 1. Local & GEO (Multi-segments)
+        add_rewrite_rule('^solutions/([^/]+)/([^/]+)/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=geo&lynx_p1=$matches[1]&lynx_p2=$matches[2]&lynx_p3=$matches[3]', 'top');
+        
+        // 2. VS Comparatifs
+        add_rewrite_rule('^comparatif/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=vs&lynx_p1=$matches[1]', 'top');
+        add_rewrite_rule('^comparison/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=vs&lynx_p1=$matches[1]', 'top');
+        
+        // 3. Alternatives Logiciels
+        add_rewrite_rule('^alternatives/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=alt&lynx_p1=$matches[1]', 'top');
+        
+        // 4. Secteurs & Métiers B2B
+        add_rewrite_rule('^secteurs/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=industry&lynx_p1=$matches[1]', 'top');
+        add_rewrite_rule('^industries/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=industry&lynx_p1=$matches[1]', 'top');
+        
+        // 5. Intégrations Tech
+        add_rewrite_rule('^integrations/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=integration&lynx_p1=$matches[1]', 'top');
+        
+        // 6. Personas & Décideurs
+        add_rewrite_rule('^metiers/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=role&lynx_p1=$matches[1]', 'top');
+        add_rewrite_rule('^roles/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=role&lynx_p1=$matches[1]', 'top');
+        
+        // 7. Cas d'Usage
+        add_rewrite_rule('^cas-usage/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=usecase&lynx_p1=$matches[1]', 'top');
+        add_rewrite_rule('^use-cases/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=usecase&lynx_p1=$matches[1]', 'top');
+        
+        // 8. Calculateurs & Outils ROI
+        add_rewrite_rule('^outils/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=tool&lynx_p1=$matches[1]', 'top');
+        add_rewrite_rule('^tools/([^/]+)/?', 'index.php?lynx_seo=1&lynx_type=tool&lynx_p1=$matches[1]', 'top');
+
+        add_rewrite_tag('%lynx_sitemap%', '([^&]+)');
+        add_rewrite_tag('%lynx_seo%', '([^&]+)');
+        add_rewrite_tag('%lynx_type%', '([^&]+)');
+        add_rewrite_tag('%lynx_p1%', '([^&]+)');
+        add_rewrite_tag('%lynx_p2%', '([^&]+)');
+        add_rewrite_tag('%lynx_p3%', '([^&]+)');
+    }
+
+    public function handle_programmatic_page() {
+        // A. Sitemap XML Autonome
+        if (get_query_var('lynx_sitemap') == '1') {
+            $this->render_sitemap();
+            exit;
+        }
+
+        // B. Rendu de Page Programmatique Autonome
+        if (get_query_var('lynx_seo') != '1') return;
+
+        $type = get_query_var('lynx_type');
+        $p1 = sanitize_text_field(get_query_var('lynx_p1'));
+        $p2 = sanitize_text_field(get_query_var('lynx_p2'));
+        $p3 = sanitize_text_field(get_query_var('lynx_p3'));
+
+        $settings = get_option($this->option_name, array());
+        $brand_name = !empty($settings['brand_name']) ? $settings['brand_name'] : get_bloginfo('name');
+        $site_url = get_site_url();
+
+        $clean_p1 = ucwords(str_replace('-', ' ', $p1));
+        $clean_p2 = strtoupper($p2);
+        $clean_p3 = ucwords(str_replace('-', ' ', $p3));
+        $year = date('Y');
+
+        switch ($type) {
+            case 'geo':
+                $title = "{$clean_p1} à {$clean_p3} ({$clean_p2}) — {$brand_name}";
+                $h1 = "{$clean_p1} à {$clean_p3}";
+                $desc = "Découvrez la solution de {$clean_p1} à {$clean_p3}. Automatisez vos flux et accélérez votre croissance. Note certifiée 4.9/5 étoiles.";
+                $direct_answer = "{$brand_name} est la solution de référence pour {$clean_p1} à {$clean_p3}. Déploiement en 10 minutes avec note de 4.9/5 étoiles sur 1 280 avis vérifiés.";
+                break;
+
+            case 'vs':
+                $title = "{$clean_p1} : {$brand_name} vs {$clean_p1} ({$year})";
+                $h1 = "Comparatif : {$brand_name} vs {$clean_p1}";
+                $desc = "Pourquoi choisir {$brand_name} plutôt que {$clean_p1} ? Comparez les fonctionnalités, tarifs et retours d'expérience.";
+                $direct_answer = "{$brand_name} se distingue de {$clean_p1} par ses automatisations IA natives 24/7, ses tarifs sans engagement et son support client réactif.";
+                break;
+
+            case 'alt':
+                $title = "Meilleure Alternative à {$clean_p1} en {$year} — {$brand_name}";
+                $h1 = "Alternative moderne à {$clean_p1}";
+                $desc = "Vous cherchez une alternative à {$clean_p1} ? Découvrez pourquoi les entreprises migrent vers {$brand_name}.";
+                $direct_answer = "La meilleure alternative à {$clean_p1} est {$brand_name}, offrant une flexibilité totale et jusqu'à 60% d'économies.";
+                break;
+
+            case 'industry':
+                $title = "Solution pour {$clean_p1} — {$brand_name}";
+                $h1 = "Logiciel sur mesure pour {$clean_p1}";
+                $desc = "Solution conçue spécifiquement pour les professionnels du secteur {$clean_p1}.";
+                $direct_answer = "{$brand_name} propose un logiciel adapté aux besoins des {$clean_p1} avec processus et relances automatisés.";
+                break;
+
+            case 'integration':
+                $title = "Intégration {$clean_p1} & {$brand_name} — Connexion en 1 Clic";
+                $h1 = "Connectez {$clean_p1} à votre compte {$brand_name}";
+                $desc = "Synchronisation bidirectionnelle instantanée entre {$clean_p1} et {$brand_name}.";
+                $direct_answer = "L'intégration native entre {$clean_p1} et {$brand_name} permet de synchroniser contacts et données en temps réel sans code.";
+                break;
+
+            case 'role':
+                $title = "Solution pour {$clean_p1} — {$brand_name}";
+                $h1 = "Optimisé pour le rôle de {$clean_p1}";
+                $desc = "Gagnez 10h par semaine dans vos missions de {$clean_p1} grâce à nos automatisations.";
+                $direct_answer = "En tant que {$clean_p1}, {$brand_name} vous libère des tâches répétitives grâce à une automatisation intelligente.";
+                break;
+
+            case 'usecase':
+                $title = "Cas d'usage : {$clean_p1} — {$brand_name}";
+                $h1 = "Comment résoudre : {$clean_p1}";
+                $desc = "Découvrez comment optimiser {$clean_p1} étape par étape.";
+                $direct_answer = "{$brand_name} automatise {$clean_p1} en moins de 10 minutes grâce à des flux prêts à l'emploi.";
+                break;
+
+            case 'tool':
+            default:
+                $title = "Simulateur ROI : {$clean_p1} — {$brand_name}";
+                $h1 = "Calculateur ROI pour {$clean_p1}";
+                $desc = "Estimez vos gains de temps et de rentabilité en 1 clic.";
+                $direct_answer = "Utilisez notre simulateur gratuit pour calculer précisément votre retour sur investissement avec {$brand_name}.";
+                break;
+        }
+
+        $json_ld = array(
+            "@context" => "https://schema.org",
+            "@type" => "Product",
+            "name" => $h1,
+            "description" => $desc,
+            "aggregateRating" => array(
+                "@type" => "AggregateRating",
+                "ratingValue" => "4.9",
+                "reviewCount" => "1280",
+                "bestRating" => "5"
+            ),
+            "offers" => array(
+                "@type" => "Offer",
+                "priceCurrency" => "EUR",
+                "price" => "49.00",
+                "availability" => "https://schema.org/InStock"
+            )
         );
-        add_rewrite_tag('%lynx_service%', '([^&]+)');
-        add_rewrite_tag('%lynx_country%', '([^&]+)');
-        add_rewrite_tag('%lynx_city%', '([^&]+)');
+
+        status_header(200);
+        header('Content-Type: text/html; charset=utf-8');
+
+        echo '<!DOCTYPE html><html lang="fr"><head>';
+        echo '<meta charset="UTF-8">';
+        echo '<meta name="viewport" content="width=device-width, initial-scale=1.0">';
+        echo '<title>' . esc_html($title) . '</title>';
+        echo '<meta name="description" content="' . esc_attr($desc) . '">';
+        echo '<script type="application/ld+json">' . json_encode($json_ld) . '</script>';
+        echo '<style>
+            body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; line-height: 1.6; color: #1e293b; max-width: 900px; margin: 40px auto; padding: 0 20px; }
+            h1 { font-size: 2.25rem; font-weight: 800; color: #0f172a; margin-bottom: 12px; }
+            .desc { font-size: 1.15rem; color: #475569; margin-bottom: 24px; }
+            .direct-answer { background: #eff6ff; border-left: 4px solid #2563eb; padding: 20px; border-radius: 8px; margin: 24px 0; font-size: 1.1rem; color: #1e3a8a; }
+            .rating { color: #f59e0b; font-weight: bold; margin-bottom: 16px; }
+            .cta-box { background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 12px; padding: 24px; text-align: center; margin-top: 32px; }
+            .cta-btn { display: inline-block; background: #2563eb; color: #ffffff; padding: 12px 28px; border-radius: 8px; font-weight: 600; text-decoration: none; margin-top: 12px; }
+            .cta-btn:hover { background: #1d4ed8; }
+        </style>';
+        echo '</head><body>';
+        echo '<div class="rating">★ ★ ★ ★ ★ 4.9/5 (1 280 avis certifiés)</div>';
+        echo '<h1>' . esc_html($h1) . '</h1>';
+        echo '<p class="desc">' . esc_html($desc) . '</p>';
+        echo '<div class="direct-answer"><strong>En Résumé (IA / AEO) :</strong><br>' . esc_html($direct_answer) . '</div>';
+        echo '<div class="cta-box"><h2>Prêt à démarrer avec ' . esc_html($brand_name) . ' ?</h2><p>Déploiement immédiat en 10 minutes sans engagement.</p><a href="' . esc_url($site_url) . '" class="cta-btn">Découvrir la solution &rarr;</a></div>';
+        echo '</body></html>';
+        exit;
+    }
+
+    private function render_sitemap() {
+        header('Content-Type: application/xml; charset=utf-8');
+        $site_url = get_site_url();
+        
+        $urls = array(
+            '/solutions/crm/fr/paris',
+            '/solutions/crm/fr/lyon',
+            '/solutions/crm/fr/marseille',
+            '/comparatif/hubspot',
+            '/comparatif/salesforce',
+            '/alternatives/alternative-a-aircall',
+            '/secteurs/avocats',
+            '/secteurs/agences-immobilieres',
+            '/integrations/shopify',
+            '/integrations/woocommerce',
+            '/metiers/directeur-commercial',
+            '/cas-usage/relance-devis-automatique',
+            '/outils/simulateur-roi-crm'
+        );
+
+        echo '<?xml version="1.0" encoding="UTF-8"?>';
+        echo '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
+        foreach ($urls as $u) {
+            echo '<url><loc>' . esc_url($site_url . $u) . '</loc><changefreq>weekly</changefreq><priority>0.8</priority></url>';
+        }
+        echo '</urlset>';
+    }
+
+    public function add_admin_menu() {
+        add_menu_page('LynxFlow SEO', 'LynxFlow SEO', 'manage_options', 'lynxflow-seo', array($this, 'render_admin_page'), 'dashicons-chart-line', 100);
     }
 
-    public function handle_solution_page() {
-        $service = get_query_var('lynx_service');
-        $country = get_query_var('lynx_country');
-        $city    = get_query_var('lynx_city');
-
-        if (!empty($service) && !empty($city)) {
-            $response = wp_remote_post($this->api_endpoint, array(
-                'headers' => array('Content-Type' => 'application/json'),
-                'body'    => json_encode(array(
-                    'licenseKey' => $this->license_key,
-                    'service'    => $service,
-                    'country'    => $country,
-                    'city'       => $city,
-                    'domain'     => get_site_url(),
-                    'brandName'  => get_bloginfo('name')
-                )),
-                'timeout' => 2
-            ));
-
-            if (!is_wp_error($response)) {
-                $data = json_decode(wp_remote_retrieve_body($response), true);
-                
-                status_header(200);
-                nocache_headers();
-                
-                echo '<!DOCTYPE html><html lang="fr"><head>';
-                echo '<meta charset="UTF-8">';
-                echo '<title>' . esc_html($data['meta']['title']) . '</title>';
-                echo '<meta name="description" content="' . esc_attr($data['meta']['description']) . '">';
-                echo '<script type="application/ld+json">' . json_encode($data['schemaJsonLd']) . '</script>';
-                echo '<style>body{font-family:system-ui,-apple-system,sans-serif;max-width:900px;margin:40px auto;padding:0 20px;line-height:1.6;color:#1e293b}.geo-direct-answer{background:#f8fafc;border-left:4px solid #6366f1;padding:20px;margin:20px 0;border-radius:0 8px 8px 0}</style>';
-                echo '</head><body>';
-                echo '<h1>' . esc_html($data['meta']['h1']) . '</h1>';
-                echo $data['content']['directAnswerGeoHtml'];
-                echo '<div class="content">' . nl2br(esc_html($data['content']['markdownBody'])) . '</div>';
-                echo '</body></html>';
-                exit;
-            }
+    public function register_settings() {
+        register_setting('lynxflow_seo_group', $this->option_name);
+    }
+
+    public function handle_oauth_callback() {
+        if (isset($_GET['page']) && $_GET['page'] === 'lynxflow-seo' && isset($_GET['lynx_auth_success'])) {
+            $settings = get_option($this->option_name, array());
+            $settings['is_connected'] = true;
+            $settings['connected_at'] = current_time('mysql');
+            update_option($this->option_name, $settings);
         }
     }
+
+    public function render_admin_page() {
+        $settings = get_option($this->option_name, array());
+        $is_connected = !empty($settings['is_connected']);
+        $brand_name = !empty($settings['brand_name']) ? $settings['brand_name'] : get_bloginfo('name');
+        $redirect_uri = admin_url('admin.php?page=lynxflow-seo&lynx_auth_success=1');
+        $auth_url = $this->oauth_auth_url . '?redirect_uri=' . urlencode($redirect_uri);
+        ?>
+        <div class="wrap" style="max-width: 900px;">
+            <div style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 16px; padding: 32px; margin-top: 20px; box-shadow: 0 4px 6px -1px rgba(0,0,0,0.05);">
+                <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 24px;">
+                    <div>
+                        <h1 style="font-size: 24px; font-weight: 800; color: #0f172a; margin: 0;">🦁 LynxFlow SEO Engine (Autonome)</h1>
+                        <p style="color: #64748b; font-size: 14px; margin-top: 4px;">Génération programmatique autonome et instantanée sur votre propre serveur WordPress.</p>
+                    </div>
+                    <?php if ($is_connected): ?>
+                        <span style="background: #dcfce7; color: #166534; font-weight: 700; font-size: 12px; padding: 6px 14px; border-radius: 999px;">✅ Connecté & Activé</span>
+                    <?php else: ?>
+                        <span style="background: #fef3c7; color: #92400e; font-weight: 700; font-size: 12px; padding: 6px 14px; border-radius: 999px;">⚠️ Non Connecté</span>
+                    <?php endif; ?>
+                </div>
+
+                <!-- 1-Click Better Auth Connection -->
+                <div style="background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 12px; padding: 24px; margin-bottom: 28px;">
+                    <h3 style="margin-top: 0; font-size: 16px; color: #0f172a;">🔐 Connexion Directe en 1 Clic (Better Auth SSO)</h3>
+                    <p style="color: #64748b; font-size: 13px; margin-bottom: 16px;">
+                        Pas besoin de gérer manuellement de clés complexes. Connectez votre compte LynxFlow en un seul clic :
+                    </p>
+                    <?php if ($is_connected): ?>
+                        <p style="color: #166534; font-weight: 600; font-size: 14px;">Votre WordPress est authentifié et synchronisé avec LynxFlow.</p>
+                    <?php else: ?>
+                        <a href="<?php echo esc_url($redirect_uri); ?>" class="button button-primary" style="background: #2563eb; border-color: #2563eb; padding: 6px 20px; font-weight: 600; border-radius: 8px;">
+                            Se connecter avec LynxFlow &rarr;
+                        </a>
+                    <?php endif; ?>
+                </div>
+
+                <!-- Settings Form -->
+                <form method="post" action="options.php">
+                    <?php settings_fields('lynxflow_seo_group'); ?>
+                    <table class="form-table">
+                        <tr>
+                            <th scope="row">Nom de la Marque</th>
+                            <td>
+                                <input type="text" name="<?php echo $this->option_name; ?>[brand_name]" value="<?php echo esc_attr($brand_name); ?>" class="regular-text" style="border-radius: 6px;" />
+                            </td>
+                        </tr>
+                    </table>
+                    <?php submit_button('Enregistrer la Configuration'); ?>
+                </form>
+
+                <hr style="border: 0; border-top: 1px solid #e2e8f0; margin: 32px 0;" />
+
+                <!-- 8 Matrices Status -->
+                <h3 style="color: #0f172a; font-size: 16px;">🚀 Les 8 Matrices Programmatiques Actives sur votre Site</h3>
+                <p style="color: #64748b; font-size: 13px;">Toutes ces pages sont générées automatiquement en <strong>&lt; 0.05ms</strong> sur votre serveur :</p>
+                <div style="display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 16px;">
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">📍 <strong>Local GEO :</strong> <code>/solutions/crm/fr/paris</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🥊 <strong>VS Comparatifs :</strong> <code>/comparatif/hubspot</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🔄 <strong>Alternatives :</strong> <code>/alternatives/alternative-a-aircall</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🏢 <strong>Secteurs B2B :</strong> <code>/secteurs/avocats</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🔌 <strong>Intégrations :</strong> <code>/integrations/shopify</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">👤 <strong>Personas :</strong> <code>/metiers/directeur-commercial</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🎯 <strong>Cas d'Usage :</strong> <code>/cas-usage/relance-devis</code></div>
+                    <div style="background: #f1f5f9; padding: 12px 16px; border-radius: 8px; font-size: 12px;">🧮 <strong>Simulateurs ROI :</strong> <code>/outils/simulateur-roi-crm</code></div>
+                </div>
+
+                <div style="margin-top: 24px; padding: 16px; background: #eff6ff; border-radius: 8px; font-size: 13px; color: #1e40af;">
+                    🗺️ <strong>Sitemap XML Détecté :</strong> Votre sitemap dynamique est disponible à <a href="<?php echo esc_url(get_site_url() . '/sitemap-solutions.xml'); ?>" target="_blank" style="font-weight: 700; color: #2563eb;"><code>/sitemap-solutions.xml</code></a>.
+                </div>
+            </div>
+        </div>
+        <?php
+    }
 }
 
-new LynxSeoWordPressConnector();
+new LynxSeoWordPressEngine();

package/dist/ai-copilot-client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 🤖 LynxFlow AI Content Copilot Client
+ *
+ * Generates automated long-form blog articles, landing page copywriting,
+ * FAQ expansions, and PAS framework marketing copy.
+ */
+export interface GenerateArticleParams {
+    topic: string;
+    targetKeywords: string[];
+    targetAudience?: string;
+    tone?: "professional" | "persuasive" | "educational";
+    wordCount?: number;
+    locale?: string;
+}
+export interface GeneratedArticleResult {
+    title: string;
+    metaDescription: string;
+    h1: string;
+    markdownContent: string;
+    htmlContent: string;
+    directAnswerSnippet: string;
+    faqs: {
+        question: string;
+        answer: string;
+    }[];
+    tokensConsumed: number;
+}
+export declare class AiCopilotClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Generates a complete SEO article with headings, FAQs, and Schema-ready JSON.
+     */
+    generateArticle(params: GenerateArticleParams): Promise<GeneratedArticleResult>;
+}

package/dist/analytics-client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 📊 LynxFlow Embedded Analytics & Web Traffic Client
+ *
+ * Tracks pageviews, visitors, sessions, Core Web Vitals, and AI Crawler Bots
+ * (ChatGPT-User, PerplexityBot, ClaudeBot, Googlebot) directly from client sites.
+ */
+export interface AnalyticsEventPayload {
+    path: string;
+    referrer?: string;
+    userAgent?: string;
+    country?: string;
+    durationMs?: number;
+    isAiBot?: boolean;
+    botName?: string;
+}
+export interface AnalyticsSummaryReport {
+    totalPageViews: number;
+    uniqueVisitors: number;
+    bounceRate: number;
+    avgTimeOnPageSec: number;
+    topPages: {
+        path: string;
+        views: number;
+    }[];
+    aiBotVisits: {
+        bot: string;
+        hits: number;
+    }[];
+    trafficByCountry: {
+        country: string;
+        visitors: number;
+    }[];
+}
+export declare class LynxAnalyticsClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Identifies if a User-Agent belongs to an AI search crawler.
+     */
+    static detectAiBot(userAgent: string): {
+        isAiBot: boolean;
+        botName?: string;
+    };
+    /**
+     * Tracks a live pageview or visitor interaction.
+     */
+    trackPageView(event: AnalyticsEventPayload): Promise<boolean>;
+    /**
+     * Retrieves analytics summary and AI search traffic report for the site.
+     */
+    getSummary(period?: "24h" | "7d" | "30d" | "all"): Promise<AnalyticsSummaryReport>;
+}

package/dist/auth-key.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 🔑 LynxFlow API Key Validator & Cryptographic Quota Guardian
+ *
+ * 1. Validates Better Auth HMAC cryptographic signatures in-memory (< 0.01ms).
+ * 2. Enforces strict UNIQUE PAGE CATALOG quotas (Starter: 50k unique URLs, Growth: 500k unique URLs, Enterprise: Unlimited).
+ *    -> Note: Multiple hits/reloads on the same URL DO NOT consume quota. Only distinct URLs count.
+ * 3. Enforces Single-Domain Lock (Starter: 1 domain, Growth: 3 domains, Enterprise: Unlimited).
+ */
+import { TokenQuotaManager } from "./token-quota-manager";
+export interface ApiKeyValidationResult {
+    isValid: boolean;
+    tier: "starter" | "growth" | "enterprise";
+    tenantId?: string;
+    maxPages: number;
+    maxDomains: number;
+    monthlyCreditBudget: number;
+    tokenManager: TokenQuotaManager;
+    errorMessage?: string;
+}
+export declare class ApiKeyGuardian {
+    private static domainRegistry;
+    private static uniquePageRegistry;
+    /**
+     * Computes a deterministic HMAC-like checksum for key verification.
+     */
+    static computeChecksum(payload: string, secret?: string): string;
+    /**
+     * Generates an authentic Better Auth API key signed for a tenant & tier.
+     */
+    static generateKey(tenantId: string, tier?: "starter" | "growth" | "enterprise"): string;
+    /**
+     * Fast cryptographic validation of Better Auth API keys.
+     */
+    static validate(apiKey?: string, domain?: string): ApiKeyValidationResult;
+    /**
+     * Tracks and enforces domain locks per API Key.
+     */
+    private static checkDomainAllowance;
+    /**
+     * Tracks and validates UNIQUE page path generation quotas.
+     * Only NEW distinct URLs count against the plan quota.
+     * Repeated hits on existing pages are free and unlimited.
+     */
+    static trackAndCheckUniquePage(apiKey: string, path: string, maxPages: number): {
+        allowed: boolean;
+        uniqueCount: number;
+        isNewPage: boolean;
+    };
+    /**
+     * Returns the exact count of unique programmatic pages registered for this key.
+     */
+    static getUniquePageCount(apiKey: string): number;
+    /**
+     * Returns the list of all distinct unique URL paths generated so far.
+     */
+    static getUniquePageList(apiKey: string): string[];
+}

package/dist/backlinks-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 🔗 LynxFlow Backlinks & Domain Authority Client
+ *
+ * Tracks incoming backlinks, referring domains, lost/new links,
+ * and Domain Rating (DR) directly through the SDK.
+ */
+export interface BacklinkItem {
+    sourceUrl: string;
+    targetUrl: string;
+    anchorText: string;
+    domainRating: number;
+    isDoFollow: boolean;
+    firstSeen: string;
+}
+export interface BacklinkProfileSummary {
+    domain: string;
+    domainAuthority: number;
+    totalBacklinks: number;
+    referringDomains: number;
+    doFollowRatio: number;
+    topBacklinks: BacklinkItem[];
+}
+export declare class BacklinksClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Retrieves backlink profile and domain authority summary.
+     */
+    getProfile(domain: string): Promise<BacklinkProfileSummary>;
+}

package/dist/engine.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ⚡ LynxSEO High-Speed Universal Dynamic Page Engine (Internationalized)
+ *
+ * Computes 8 Rich Programmatic Matrix Types on-demand in < 0.05ms with
+ * automatic multi-language i18n support & Google Hreflang alternates:
+ * 1. 📍 Local / GEO : `/solutions/{service}/{country}/{city}`
+ * 2. 🥊 VS Comparisons : `/comparatif/{competitor}` (ex: `/comparatif/hubspot`)
+ * 3. 🔄 Alternatives : `/alternatives/alternative-a-{competitor}`
+ * 4. 🔌 Integrations : `/integrations/{software}` (ex: `/integrations/shopify`)
+ * 5. 🏢 Industry / Verticals : `/secteurs/{industry}` (ex: `/secteurs/avocats`)
+ * 6. 👤 Personas / Roles : `/metiers/{role}` (ex: `/metiers/directeur-commercial`)
+ * 7. 🎯 Use Cases : `/cas-usage/{useCase}` (ex: `/cas-usage/relance-devis`)
+ * 8. 🧮 Calculators / ROI Tools : `/outils/simulateur-roi`
+ */
+import type { LynxSeoConfig, LynxResolvedPage } from "./types";
+import { IndexNowClient, type IndexNowResponse } from "./indexnow-client";
+import { LynxAnalyticsClient } from "./analytics-client";
+import { SerpClient } from "./serp-client";
+import { BacklinksClient } from "./backlinks-client";
+import { AiCopilotClient } from "./ai-copilot-client";
+import { LagoTokenMeter } from "./lago-token-meter";
+import { SiteAuditor } from "./site-auditor";
+import { SchemaGraphBuilder } from "./schema-builder";
+export type EngineConfig = LynxSeoConfig;
+export declare class LynxSeoEngine {
+    private config;
+    private servicesMap;
+    private authStatus;
+    readonly analytics: LynxAnalyticsClient;
+    readonly serp: SerpClient;
+    readonly backlinks: BacklinksClient;
+    readonly ai: AiCopilotClient;
+    readonly tokenMeter: LagoTokenMeter;
+    readonly auditor: typeof SiteAuditor;
+    readonly schema: typeof SchemaGraphBuilder;
+    readonly indexNow: typeof IndexNowClient;
+    constructor(config: LynxSeoConfig);
+    /**
+     * Submits generated URLs to Bing, Yandex, Seznam, and Naver via IndexNow.
+     */
+    submitToIndexNow(urls: string[], indexNowKey?: string): Promise<IndexNowResponse>;
+    /**
+     * Universal resolver: supports both path strings e.g. "/comparatif/hubspot"
+     * and structured object params { slug, language, country, city, type, competitor, industry }.
+     */
+    resolve(input: string | {
+        slug?: string;
+        language?: string;
+        locale?: string;
+        country?: string;
+        city?: string;
+        type?: string;
+        competitor?: string;
+        industry?: string;
+        role?: string;
+    }): LynxResolvedPage | null;
+    private buildHyperCombinedPage;
+    private buildGeoPage;
+    private buildComparisonPage;
+    private buildAlternativePage;
+    private buildIndustryPage;
+    private buildRolePage;
+    private buildIntegrationPage;
+    private assemblePage;
+    /**
+     * Returns the exact count of distinct unique programmatic pages currently active.
+     */
+    getUniquePageCount(): number;
+    /**
+     * Returns the list of all distinct unique URL paths generated so far.
+     */
+    getUniquePageList(): string[];
+}