@lynxflow/seo-engine 2.8.0 → 3.2.1

package/dist/plugins/media-analytics/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * LynxSEO - Media / Video Analytics Plugin
+ * Mesure des performances des contenus vidéo et audio :
+ * lectures, pauses, complétions, temps de visionnage et rétention par tranche.
+ * Inspiré de Matomo Media Analytics (GPLv3 / AGPLv3 compatible).
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type MediaType = "video" | "audio";
+export interface MediaMilestones {
+    p25: number;
+    p50: number;
+    p75: number;
+    p100: number;
+}
+export interface MediaRetentionPoint {
+    progressPct: number;
+    viewers: number;
+    retentionPct: number;
+}
+export interface MediaSummary {
+    mediaId: string;
+    mediaTitle?: string;
+    mediaType: MediaType;
+    resource?: string;
+    pageUrl?: string;
+    plays: number;
+    pauses: number;
+    completions: number;
+    completionRatePct: number;
+    totalTimeWatchedSec: number;
+    avgWatchTimeSec: number;
+    mediaLengthSec: number;
+    milestones: MediaMilestones;
+}
+export interface MediaDetailReport extends MediaSummary {
+    retentionCurve: MediaRetentionPoint[];
+}
+export declare class MediaAnalyticsService {
+    private media;
+    recordPlay(siteId: string, mediaId: string, mediaTitle?: string, mediaType?: MediaType, mediaLengthSec?: number, resource?: string, pageUrl?: string): void;
+    recordPause(siteId: string, mediaId: string): void;
+    recordProgress(siteId: string, mediaId: string, progressPct: number, watchedSec?: number): void;
+    recordComplete(siteId: string, mediaId: string, watchedSec?: number): void;
+    listMedia(siteId: string): MediaSummary[];
+    getMediaDetail(siteId: string, mediaId: string): MediaDetailReport | null;
+    reset(siteId?: string): void;
+    private getMediaData;
+}
+export declare class MediaAnalyticsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    listMedia(siteId: string): MediaSummary[];
+    getMediaDetail(siteId: string, mediaId: string): MediaDetailReport | null;
+    getService(): MediaAnalyticsService;
+}
+export default MediaAnalyticsPlugin;

package/dist/plugins/mobile-app-measurable/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Mobile App Measurable Plugin (Inspiré de Matomo MobileAppMeasurable & PostHog Mobile SDK)
+ *
+ * Fournit une suite complète d'analytique pour applications mobiles natives et hybrides
+ * (iOS, Android, React Native, Flutter, Expo) : tracking d'écrans, versions d'OS,
+ * crash reporting mobile et attribution de téléchargements.
+ */
+import type { LynxSeoPlugin, PluginManifest, PluginContext } from "../../plugin/types";
+export type MobilePlatform = "ios" | "android" | "react-native" | "flutter" | "expo";
+export interface MobileAppConfig {
+    id: string;
+    projectId: string;
+    appName: string;
+    bundleId: string;
+    platform: MobilePlatform;
+    latestVersion: string;
+    apiKey: string;
+    status: "active" | "inactive";
+    totalInstalls: number;
+    activeUsers30d: number;
+    crashFreeSessionRate: number;
+    createdAt: string;
+}
+export interface MobileScreenMetric {
+    screenName: string;
+    screenClass: string;
+    screenViews: number;
+    averageTimeSeconds: number;
+    crashCount: number;
+}
+export interface MobileVersionBreakdown {
+    appVersion: string;
+    activeSessions: number;
+    sharePercent: number;
+    crashRate: number;
+}
+export interface MobileDeviceBreakdown {
+    deviceModel: string;
+    osVersion: string;
+    activeSessions: number;
+    sharePercent: number;
+}
+export interface MobileCrashSummary {
+    id: string;
+    exceptionType: string;
+    message: string;
+    occurrences: number;
+    affectedUsers: number;
+    appVersion: string;
+    osVersion: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    resolved: boolean;
+}
+export interface MobileAppMeasurableReport {
+    projectId: string;
+    apps: MobileAppConfig[];
+    screens: MobileScreenMetric[];
+    versions: MobileVersionBreakdown[];
+    devices: MobileDeviceBreakdown[];
+    recentCrashes: MobileCrashSummary[];
+    totalSessions30d: number;
+    globalCrashFreeRate: number;
+}
+export declare class MobileAppMeasurablePlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    private apps;
+    private crashes;
+    init(_context: PluginContext): Promise<void>;
+    registerApp(params: {
+        projectId: string;
+        appName: string;
+        bundleId: string;
+        platform: MobilePlatform;
+        latestVersion?: string;
+    }): MobileAppConfig;
+    resolveCrash(crashId: string, resolved?: boolean): boolean;
+    deleteApp(appId: string): boolean;
+    getMobileReport(projectId: string): MobileAppMeasurableReport;
+}

package/dist/plugins/mobile-messaging/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * LynxSEO - Mobile Messaging Plugin (Passerelle SMS & Alertes Mobiles d'Urgence)
+ * Inspiré de Matomo MobileMessaging (GPLv3 / AGPLv3 compatible).
+ *
+ * Envoi d'alertes métriques critiques par SMS (Twilio, Infobip, Sinch ou Webhook),
+ * validation E.164, vérification par code à 6 chiffres et calcul GSM 7-bit vs UCS-2.
+ */
+import type { LynxSeoPlugin, PluginManifest, PluginContext, PluginEvent } from "../../plugin/types";
+export type SmsProviderType = "twilio" | "infobip" | "sinch" | "webhook" | "mock";
+export interface SmsProviderConfig {
+    provider: SmsProviderType;
+    accountSid?: string;
+    apiKey?: string;
+    apiSecret?: string;
+    fromNumberOrSenderId: string;
+    webhookUrl?: string;
+    enabled: boolean;
+}
+export interface VerifiedPhoneNumber {
+    id: string;
+    siteId: string;
+    phoneNumber: string;
+    label: string;
+    verified: boolean;
+    verificationCode?: string;
+    verificationSentAt?: string;
+    createdAt: string;
+}
+export interface SmsMessageRecord {
+    id: string;
+    siteId: string;
+    recipientPhone: string;
+    content: string;
+    segmentsCount: number;
+    encoding: "GSM_7BIT" | "UCS_2";
+    status: "sent" | "delivered" | "failed" | "simulated";
+    errorMessage?: string;
+    sentAt: string;
+}
+export interface SmsMetricsEstimate {
+    characterCount: number;
+    encoding: "GSM_7BIT" | "UCS_2";
+    segmentCount: number;
+    remainingInCurrentSegment: number;
+}
+export interface MobileMessagingReport {
+    siteId: string;
+    providerConfigured: boolean;
+    activeProvider?: SmsProviderType;
+    verifiedNumbers: VerifiedPhoneNumber[];
+    totalSentMessages: number;
+    totalSegmentsConsumed: number;
+    recentMessages: SmsMessageRecord[];
+}
+export declare class MobileMessagingPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private providerConfig;
+    private phoneNumbers;
+    private messageHistory;
+    private context?;
+    private static readonly GSM_7BIT_CHARS;
+    enable(context: PluginContext): void;
+    /**
+     * Calcule avec précision l'encodage (GSM 7-bit vs Unicode UCS-2) et le nombre de segments SMS requis.
+     */
+    static calculateSmsMetrics(message: string): SmsMetricsEstimate;
+    /**
+     * Valide la conformité du numéro au format international E.164 (+336..., +1415...)
+     */
+    static isValidE164(phone: string): boolean;
+    configureProvider(siteId: string, config: SmsProviderConfig): void;
+    getProviderConfig(siteId: string): SmsProviderConfig | undefined;
+    addPhoneNumber(siteId: string, phoneNumber: string, label: string): VerifiedPhoneNumber;
+    verifyPhoneNumber(siteId: string, phoneId: string, code: string): boolean;
+    deletePhoneNumber(siteId: string, phoneId: string): boolean;
+    sendSms(siteId: string, recipientPhone: string, content: string): Promise<SmsMessageRecord>;
+    /**
+     * Envoie une alerte automatique à tous les numéros vérifiés du site.
+     */
+    broadcastMetricAlert(siteId: string, alertTitle: string, metricDetails: string): Promise<SmsMessageRecord[]>;
+    getReport(siteId: string): MobileMessagingReport;
+    onEvent(event: PluginEvent): Promise<void>;
+    destroy(): Promise<void>;
+}

package/dist/plugins/multi-sites/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LynxSEO - MultiSites Plugin
+ * Inspiré de Matomo MultiSites (GPLv3 / AGPLv3 compatible).
+ *
+ * Agrégation et comparatifs multi-sites : tableaux de bord cross-site,
+ * comparatifs de performance, roll-up des métriques.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface SiteMetric {
+    siteId: string;
+    siteName: string;
+    metric: string;
+    value: number;
+    timestamp: string;
+}
+export interface SiteComparison {
+    siteId: string;
+    siteName: string;
+    visits: number;
+    pageviews: number;
+    bounceRate: number;
+    avgTimeOnSite: number;
+}
+export declare class MultiSitesPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private sites;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    private extractValue;
+    /**
+     * Enregistre/déclare un site avec son nom.
+     */
+    registerSite(siteId: string, siteName: string): void;
+    /**
+     * Récupère la comparaison entre tous les sites.
+     */
+    getComparison(): SiteComparison[];
+    /**
+     * Récupère les métriques agrégées pour un site.
+     */
+    getSiteMetrics(siteId: string): SiteMetric[];
+    disable(): Promise<void>;
+}
+export default MultiSitesPlugin;

package/dist/plugins/overlay/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LynxSEO - Overlay & Heatmap Plugin
+ * Inspiré de Matomo Overlay (GPLv3 / AGPLv3 compatible).
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ClickRecord {
+    x: number;
+    y: number;
+    pageUrl: string;
+    elementSelector?: string;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    timestamp: string;
+    sessionId?: string;
+}
+export interface HeatmapDensityPoint {
+    x: number;
+    y: number;
+    intensity: number;
+}
+export interface PageOverlaySummary {
+    pageUrl: string;
+    totalClicks: number;
+    clicksBySelector: Record<string, number>;
+    topElements: Array<{
+        selector: string;
+        clicks: number;
+        percentage: number;
+    }>;
+    heatmapPoints: HeatmapDensityPoint[];
+}
+export declare class HeatmapOverlayService {
+    /**
+     * Agrège les clics d'une page pour construire une matrice de densité (Heatmap)
+     * et un rapport d'interaction par sélecteur CSS.
+     */
+    static generateOverlayReport(clicks: ClickRecord[], targetUrl?: string): PageOverlaySummary;
+}
+export declare class OverlayPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private clicksBySite;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    getClicks(siteId: string, pageUrl?: string): ClickRecord[];
+    getOverlayReport(siteId: string, pageUrl?: string): PageOverlaySummary;
+    reset(siteId: string): void;
+}
+export default OverlayPlugin;

package/dist/plugins/page-performance/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * LynxSEO - Page Performance Plugin (RUM)
+ * Inspiré de Matomo PagePerformance (GPLv3 / AGPLv3 compatible).
+ *
+ * Collecte les métriques de chargement réel (Navigation Timing) depuis le tracker JS.
+ * Écoute tracker.page-performance et agrège les métriques par page.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+import { type NavigationTimingMetrics } from "../../real-user-monitoring";
+export declare class RUMPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Agrège les métriques RUM pour un site (et optionnellement une page).
+     */
+    aggregate(siteId: string, pageUrl?: string): import("../../real-user-monitoring").PagePerformanceAggregated | null;
+    /**
+     * Récupère les échantillons RUM bruts pour un site.
+     */
+    getSamples(siteId: string, limit?: number): NavigationTimingMetrics[];
+    /**
+     * Nombre d'échantillons RUM pour un site.
+     */
+    countSamples(siteId: string): number;
+    disable(): Promise<void>;
+}
+export { RUMPlugin as PagePerformancePlugin };
+export default RUMPlugin;

package/dist/plugins/privacy-manager/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * LynxSEO - Privacy Manager Plugin (RGPD)
+ * Inspiré de Matomo Privacy Manager (GPLv3 / AGPLv3 compatible).
+ *
+ * Droit à l'oubli, anonymisation des logs, export des données personnelles,
+ * gestion du consentement tracking.
+ */
+import { type LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ConsentRecord {
+    visitorId: string;
+    siteId: string;
+    consent: boolean;
+    timestamp: string;
+    source: "banner" | "header" | "cookie" | "api";
+}
+export interface ErasureRequest {
+    id: string;
+    visitorId?: string;
+    userId?: string;
+    siteId: string;
+    status: "pending" | "completed" | "failed";
+    requestedAt: string;
+    completedAt?: string;
+}
+export interface PrivacyReport {
+    siteId: string;
+    gdprComplianceScore: number;
+    consentStats: {
+        total: number;
+        granted: number;
+        denied: number;
+        optInRate: number;
+    };
+    erasures: {
+        pending: number;
+        completed: number;
+        total: number;
+    };
+    ipAnonymizationEnabled: boolean;
+}
+export declare class PrivacyManagerPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private consents;
+    private erasureRequests;
+    private anonymizedVisitorIds;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Enregistre le consentement d'un visiteur.
+     */
+    setConsent(visitorId: string, siteId: string, consent: boolean, source?: ConsentRecord["source"]): void;
+    /**
+     * Vérifie si un visiteur a consenti au tracking.
+     */
+    hasConsent(visitorId: string): boolean;
+    /**
+     * Demande l'effacement des données d'un visiteur (droit à l'oubli RGPD).
+     */
+    requestErasure(visitorId?: string, userId?: string, siteId?: string): string;
+    /**
+     * Effectue l'effacement/anonymisation des données d'un visiteur.
+     */
+    eraseVisitorData(visitorId: string): Promise<void>;
+    /**
+     * Exporte toutes les données personnelles d'un visiteur (portabilité RGPD).
+     */
+    exportVisitorData(visitorId: string): {
+        visitorId: string;
+        consent: ConsentRecord | undefined;
+        anonymized: boolean;
+        exportedAt: string;
+    };
+    /**
+     * Liste les demandes d'effacement en attente.
+     */
+    getPendingErasureRequests(): ErasureRequest[];
+    /** Consentements enregistrés, éventuellement restreints à un site. */
+    listConsents(siteId?: string): ConsentRecord[];
+    /** Demandes d'effacement, éventuellement restreintes à un site. */
+    listErasureRequests(siteId?: string): ErasureRequest[];
+    /**
+     * Agrégats de conformité : consentements par décision/source et état des
+     * demandes d'effacement.
+     */
+    getStats(siteId?: string): {
+        consents: {
+            granted: number;
+            denied: number;
+            total: number;
+        };
+        sources: {
+            source: string;
+            count: number;
+        }[];
+        erasures: {
+            pending: number;
+            completed: number;
+            failed: number;
+            total: number;
+        };
+        pendingErasures: ErasureRequest[];
+        anonymizedVisitors: number;
+    };
+    getReport(siteId: string): PrivacyReport;
+    disable(): Promise<void>;
+}
+export default PrivacyManagerPlugin;

package/dist/plugins/product-tours/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ProductTours Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo Core : Plugin Tour (Visites guidées interactives, onboarding, checklist de découverte)
+ * - PostHog Platform : Product Tours & Onboarding Walkthroughs (Étapes, ancrages sélecteurs CSS, funnel de complétion)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export interface TourStep {
+    stepId: string;
+    title: string;
+    content: string;
+    targetSelector: string;
+    placement: "top" | "bottom" | "left" | "right" | "center";
+    isRequired?: boolean;
+}
+export interface ProductTourDefinition {
+    id: string;
+    title: string;
+    description: string;
+    category: "onboarding" | "feature_discovery" | "advanced_analytics";
+    targetAudience: "all" | "new_users" | "admins";
+    steps: TourStep[];
+    isActive: boolean;
+}
+export interface TourProgressStats {
+    tourId: string;
+    tourTitle: string;
+    startedCount: number;
+    completedCount: number;
+    completionRatePct: number;
+    stepDropoffs: Array<{
+        stepId: string;
+        stepTitle: string;
+        viewsCount: number;
+        completionPct: number;
+    }>;
+}
+export interface ProductToursReport {
+    siteId: string;
+    activeTours: ProductTourDefinition[];
+    stats: TourProgressStats[];
+    userDismissedTours: string[];
+}
+export declare class ProductToursPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private tours;
+    private progressEvents;
+    constructor();
+    enable(_ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    registerTour(tour: ProductTourDefinition): void;
+    getTour(tourId: string): ProductTourDefinition | undefined;
+    getReport(siteId: string, currentUserId?: string): ProductToursReport;
+    private initDefaultTours;
+}

package/dist/plugins/provider/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * LynxSEO - Provider & Network Intelligence Plugin
+ * Analyse des fournisseurs d'accès (ISP / ASN), détection du type de réseau
+ * (résidentiel, corporate, datacenter/cloud, mobile, éducation) et détection
+ * de prospects B2B par organisation réseau — Parité Matomo Provider & PostHog Network.
+ *
+ * @license AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin/types";
+export type NetworkKind = "residential" | "corporate" | "datacenter" | "mobile" | "education" | "unknown";
+export interface ProviderStat {
+    providerName: string;
+    asn?: number;
+    kind: NetworkKind;
+    visits: number;
+    percentage: number;
+    isCloudOrBotRisk: boolean;
+}
+export interface B2BProspectCompany {
+    companyName: string;
+    asn?: number;
+    visits: number;
+    pagesViewed: number;
+    firstSeen: string;
+    lastSeen: string;
+    samplePaths: string[];
+}
+export interface ProviderReport {
+    siteId: string;
+    totalVisits: number;
+    datacenterVisits: number;
+    datacenterPercentage: number;
+    topProviders: ProviderStat[];
+    networkDistribution: Record<NetworkKind, number>;
+    networkDistributionPct: Record<NetworkKind, number>;
+    b2bProspects: B2BProspectCompany[];
+}
+export declare class ProviderPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private readonly visitsBySite;
+    enable(_ctx: PluginContext): Promise<void>;
+    /**
+     * Détermine le type de réseau et l'indicateur de risque datacenter/bot à partir de l'ASN et du nom de l'organisation.
+     */
+    classifyNetwork(asn?: number | string, asOrganization?: string): {
+        kind: NetworkKind;
+        isCloudOrBotRisk: boolean;
+    };
+    onEvent(event: PluginEvent): Promise<void>;
+    getReport(siteId: string): ProviderReport;
+    reset(siteId: string): void;
+}
+export default ProviderPlugin;

package/dist/plugins/query-cost-profiler/index.d.ts

@@ -0,0 +1 @@
+export * from "./query-cost-profiler";

package/dist/plugins/query-cost-profiler/query-cost-profiler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * QueryCostProfilerPlugin — Profiler de coût, latence et optimisation des requêtes SQL Pulse
+ *
+ * Inspiré de PostHog Query Performance scene, de ClickHouse Query Log
+ * et de pg_stat_statements.
+ *
+ * Implémentation Clean-Room indépendante sous licence AGPL-3.0.
+ */
+import type { LynxSeoPlugin, PluginManifest } from "../../plugin/types";
+export interface QueryExecutionEntry {
+    queryId: string;
+    sql: string;
+    durationMs: number;
+    rowsRead?: number;
+    bytesScanned?: number;
+    timestamp?: string | Date;
+    error?: string;
+    tag?: string;
+}
+export interface LatencyPercentiles {
+    p50Ms: number;
+    p90Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    maxMs: number;
+    avgMs: number;
+}
+export interface QueryOptimizationRecommendation {
+    id: string;
+    severity: "HIGH" | "MEDIUM" | "LOW";
+    title: string;
+    suggestion: string;
+    affectedQuerySnippet?: string;
+}
+export interface QueryCostProfileReport {
+    totalQueriesExecuted: number;
+    totalErrorsCount: number;
+    slowQueriesCount: number;
+    slowQueryRatePct: number;
+    totalBytesScanned: number;
+    totalRowsRead: number;
+    latency: LatencyPercentiles;
+    queryHealthScore: number;
+    recommendations: QueryOptimizationRecommendation[];
+    topSlowQueries: Array<{
+        queryId: string;
+        sql: string;
+        durationMs: number;
+        bytesScanned: number;
+        tag?: string;
+    }>;
+    generatedAt: string;
+}
+export declare class QueryCostProfilerPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    readonly id = "query-cost-profiler";
+    readonly name = "SQL Query Cost & Performance Profiler";
+    readonly version = "1.0.0";
+    private slowThresholdMs;
+    private queries;
+    private maxHistory;
+    constructor(slowThresholdMs?: number);
+    setSlowThresholdMs(ms: number): void;
+    reset(): void;
+    recordQuery(entry: QueryExecutionEntry): void;
+    getProfileReport(): QueryCostProfileReport;
+}