@lynxflow/seo-engine 2.8.0 → 3.2.0

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

@@ -0,0 +1,73 @@
+/**
+ * RevenueAnalytics Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - PostHog Platform : Revenue Analytics (MRR, ARR, Expansion vs Churn, LTV, CAC, NRR, cohortes de revenus)
+ * - Matomo Advanced Ecommerce : Attribution financière des conversions par canal de référencement (SEO Organique vs Payant)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export type TransactionType = "new" | "renewal" | "upgrade" | "churn" | "refund";
+export interface RevenueTransaction {
+    id: string;
+    siteId: string;
+    customerId: string;
+    amountUsd: number;
+    type: TransactionType;
+    plan: string;
+    channel: string;
+    channelName: string;
+    timestamp: string;
+}
+export interface ChannelRevenueBreakdown {
+    channel: string;
+    channelName: string;
+    totalRevenueUsd: number;
+    transactionsCount: number;
+    customersCount: number;
+    avgOrderValueUsd: number;
+    sharePercent: number;
+}
+export interface RevenueAnalyticsReport {
+    siteId: string;
+    period: string;
+    mrr: number;
+    arr: number;
+    totalRevenue: number;
+    netNewMrr: number;
+    expansionMrr: number;
+    churnedMrr: number;
+    ltvUsd: number;
+    cacUsd: number;
+    ltvCacRatio: number;
+    nrrPercent: number;
+    revenueByChannel: ChannelRevenueBreakdown[];
+    topPlans: Array<{
+        plan: string;
+        mrr: number;
+        customersCount: number;
+    }>;
+    recentTransactions: RevenueTransaction[];
+}
+export interface RecordTransactionInput {
+    customerId: string;
+    amountUsd: number;
+    type?: TransactionType;
+    plan?: string;
+    channel?: string;
+}
+export declare class RevenueAnalyticsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private context?;
+    private transactionsBySite;
+    enable(ctx: PluginContext): void;
+    onEvent(event: PluginEvent): void;
+    private resolveChannelName;
+    recordTransaction(siteId: string, input: RecordTransactionInput): RevenueTransaction;
+    getStats(siteId: string): RevenueAnalyticsReport;
+    getReport(siteId: string, options?: {
+        period?: string;
+    }): RevenueAnalyticsReport;
+    private getDefaultReport;
+}

package/dist/plugins/scheduled-reports/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * LynxSEO - Scheduled Reports Plugin
+ * Rapports planifiés par email (jour/semaine/mois), formats PDF/HTML, gestion des destinataires.
+ * Inspiré de Matomo ScheduledReports (GPLv3 / AGPLv3 compatible).
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ScheduledReport {
+    id: string;
+    siteId: string;
+    name: string;
+    description?: string;
+    format: "pdf" | "html" | "csv";
+    frequency: "hourly" | "daily" | "weekly" | "monthly";
+    recipients: string[];
+    lastSent?: string;
+    nextRun?: string;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ScheduledReportJob {
+    reportId: string;
+    siteId: string;
+    runAt: string;
+}
+export declare class ScheduledReportsService {
+    private reports;
+    private jobs;
+    createReport(report: Omit<ScheduledReport, "id" | "createdAt" | "updatedAt"> & {
+        id?: string;
+    }): ScheduledReport;
+    getReport(reportId: string): ScheduledReport | undefined;
+    listReports(siteId?: string): ScheduledReport[];
+    updateReport(reportId: string, patch: Partial<ScheduledReport>): ScheduledReport | undefined;
+    deleteReport(reportId: string): boolean;
+    setActive(reportId: string, active: boolean): ScheduledReport | undefined;
+    getJobs(): ScheduledReportJob[];
+    markSent(reportId: string): void;
+    private computeNextRun;
+    private scheduleJob;
+    getDueJobs(now?: string): ScheduledReportJob[];
+    reset(): void;
+}
+export declare class ScheduledReportsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(_ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+    /** Crée un rapport planifié. */
+    createReport(report: Omit<ScheduledReport, "id" | "createdAt" | "updatedAt"> & {
+        id?: string;
+    }): ScheduledReport;
+    /** Liste les rapports (optionnellement filtrés par site). */
+    listReports(siteId?: string): ScheduledReport[];
+    /** Met à jour un rapport. */
+    updateReport(reportId: string, patch: Partial<ScheduledReport>): ScheduledReport | undefined;
+    /** Supprime un rapport. */
+    deleteReport(reportId: string): boolean;
+    /** Active/désactive un rapport. */
+    setActive(reportId: string, active: boolean): ScheduledReport | undefined;
+    /** Récupère les jobs à exécuter maintenant. */
+    getDueJobs(now?: string): ScheduledReportJob[];
+    /** Marque un rapport comme envoyé. */
+    markSent(reportId: string): void;
+    /** Récupère le service (pour les tests / intégration). */
+    getService(): ScheduledReportsService;
+    reset(): void;
+}
+export default ScheduledReportsPlugin;

package/dist/plugins/security-info/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SecurityInfo Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo Core : Plugin SecurityInfo (audit des en-têtes HTTP, sécurisation des cookies, exposition, TLS)
+ * - PostHog Platform : Security & Access Control audit (masquage PII, conformité GDPR, rate-limiting, Turnstile)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export type SecurityCheckStatus = "pass" | "warn" | "fail";
+export type SecuritySeverity = "low" | "medium" | "high" | "critical";
+export interface SecurityCheckResult {
+    id: string;
+    category: "http_headers" | "authentication" | "data_privacy" | "abuse_prevention" | "gdpr_compliance";
+    title: string;
+    status: SecurityCheckStatus;
+    severity: SecuritySeverity;
+    scoreImpact: number;
+    message: string;
+    remediation?: string;
+}
+export interface SecurityInfoReport {
+    overallScore: number;
+    grade: "A+" | "A" | "B" | "C" | "D" | "F";
+    summary: {
+        totalChecks: number;
+        passed: number;
+        warnings: number;
+        failed: number;
+    };
+    checks: SecurityCheckResult[];
+    authModeDetected: string;
+    turnstileEnabled: boolean;
+    gdprSignatureActive: boolean;
+    auditedAt: string;
+}
+export declare class SecurityInfoPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    enable(_ctx: PluginContext): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+    auditHeaders(headers: Record<string, string>): SecurityCheckResult[];
+    auditAuthMode(authMode: string): SecurityCheckResult;
+    auditPiiAndGdpr(options: {
+        ipAnonymization: boolean;
+        replayTextMasking: boolean;
+        turnstileActive: boolean;
+        gdprHmacSigned: boolean;
+    }): SecurityCheckResult[];
+    getReport(options?: {
+        headers?: Record<string, string>;
+        authMode?: string;
+        ipAnonymization?: boolean;
+        replayTextMasking?: boolean;
+        turnstileActive?: boolean;
+        gdprHmacSigned?: boolean;
+    }): SecurityInfoReport;
+}

package/dist/plugins/segment-editor/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * LynxSEO - Segment Editor Plugin
+ * Inspiré de Matomo SegmentEditor (GPLv3 / AGPLv3 compatible).
+ *
+ * Édition de segments nommés : création, mise à jour, suppression, favoris et
+ * évaluation d'un segment contre des visiteurs.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type SegmentOperator = "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "in" | "contains";
+export interface SegmentCondition {
+    field: string;
+    operator: SegmentOperator;
+    value: unknown;
+}
+export interface SegmentDefinition {
+    id: string;
+    siteId: string;
+    name: string;
+    definition: string;
+    conditions: SegmentCondition[];
+    starred: boolean;
+    /** Segment automatique non supprimable (ex: "Visiteurs de retour"). */
+    autoArchive?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SegmentInput {
+    name: string;
+    conditions: SegmentCondition[];
+    definition?: string;
+    starred?: boolean;
+    autoArchive?: boolean;
+}
+export interface SegmentEvaluation {
+    segmentId: string;
+    matched: number;
+    total: number;
+    matchRate: number;
+}
+/** Longueur maximale du nom d'un segment (contrôle d'unicité Matomo). */
+export declare const MAX_SEGMENT_NAME_LENGTH = 255;
+/** Toutes les conditions doivent être vraies (ET logique, comme Matomo Segment). */
+export declare function matchesSegment(segment: SegmentDefinition, visitor: Record<string, unknown>): boolean;
+export declare class SegmentEditorPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private segments;
+    private sequence;
+    enable(ctx: PluginContext): Promise<void>;
+    /** Matomo SegmentEditor.add. */
+    add(siteId: string, input: SegmentInput): SegmentDefinition;
+    /** Matomo SegmentEditor.update. */
+    update(siteId: string, id: string, patch: Partial<SegmentInput>): SegmentDefinition | null;
+    /** Matomo SegmentEditor.delete — refuse les segments auto-archivés. */
+    delete(siteId: string, id: string): boolean;
+    /** Matomo SegmentEditor.star / unstar. */
+    toggleStar(siteId: string, id: string, starred?: boolean): SegmentDefinition | null;
+    /** Matomo SegmentEditor.get. */
+    get(siteId: string, id: string): SegmentDefinition | null;
+    /** Matomo SegmentEditor.getAll. */
+    getAll(siteId: string): SegmentDefinition[];
+    /** Matomo SegmentEditor.getSegmentData : évaluation sur un jeu de visiteurs. */
+    getSegmentData(siteId: string, id: string, visitors: Record<string, unknown>[]): SegmentEvaluation | null;
+    /** Filtre direct par identifiant de segment. */
+    filter(siteId: string, id: string, visitors: Record<string, unknown>[]): Record<string, unknown>[];
+    reset(siteId: string): void;
+    disable(): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+    private findById;
+    /** Représentation textuelle type Matomo : "countryCode==fr;deviceType==smartphone". */
+    private serialize;
+}
+export default SegmentEditorPlugin;

package/dist/plugins/site-search/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SiteSearchIntelligence Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo Core : Plugin Actions/SiteSearch (Mots-clés de recherche interne, catégories, pages sans résultat, taux de clics post-recherche)
+ * - PostHog Platform : Taxonomic Search Intent & Keyword Discovery
+ * - LynxSEO Extension : Générateur d'opportunités de contenu SEO & pSEO basé sur les recherches internes infructueuses (Zero-Result Searches)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export interface SearchQueryRecord {
+    query: string;
+    category?: string;
+    resultsCount: number;
+    hitsCount: number;
+    uniqueUsersCount: number;
+    lastSearchedAt: string;
+    noResultRate: number;
+    intentType: "informational" | "transactional" | "navigational" | "investigational";
+}
+export interface SiteSearchIntelligenceReport {
+    siteId: string;
+    period: string;
+    totalSearches: number;
+    uniqueSearchQueriesCount: number;
+    zeroResultSearchesCount: number;
+    zeroResultPercentage: number;
+    searchPenetrationRate: number;
+    topQueries: SearchQueryRecord[];
+    zeroResultQueries: SearchQueryRecord[];
+    contentGapRecommendations: Array<{
+        suggestedKeyword: string;
+        searchesCount: number;
+        recommendedTopic: string;
+        urgency: "high" | "medium" | "low";
+    }>;
+}
+export declare class SiteSearchIntelligencePlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private context?;
+    private searchesBySite;
+    private totalVisitsBySite;
+    enable(ctx: PluginContext): void;
+    onEvent(event: PluginEvent): void;
+    recordSearch(siteId: string, query: string, category?: string, resultsCount?: number, userId?: string, timestamp?: string): void;
+    getStats(siteId: string): SiteSearchIntelligenceReport;
+    getReport(siteId: string, options?: {
+        limit?: number;
+        minHits?: number;
+    }): SiteSearchIntelligenceReport;
+    private classifySearchIntent;
+    private generateContentGaps;
+    private getDefaultReport;
+}

package/dist/plugins/smart-alerts-anomaly/index.d.ts

@@ -0,0 +1,61 @@
+import type { LynxSeoPlugin, PluginManifest, PluginContext } from "../../plugin/types";
+export type AnomalyMetric = "error_rate" | "latency_p95" | "traffic_drop" | "bounce_rate_spike" | "conversion_drop";
+export type IncidentSeverity = "critical" | "warning" | "info";
+export interface AnomalyRule {
+    id: string;
+    name: string;
+    metric: AnomalyMetric;
+    sensitivity: "low" | "medium" | "high";
+    enabled: boolean;
+    notificationChannels: ("email" | "slack" | "webhook")[];
+    createdAt: string;
+}
+export interface AnomalyIncident {
+    id: string;
+    ruleId: string;
+    ruleName: string;
+    metric: AnomalyMetric;
+    severity: IncidentSeverity;
+    observedValue: number;
+    expectedRange: {
+        min: number;
+        max: number;
+    };
+    deviationPercent: number;
+    status: "active" | "acknowledged" | "resolved";
+    detectedAt: string;
+    resolvedAt?: string;
+    rootCauseCandidate?: string;
+}
+export interface SmartAlertsReport {
+    projectId: string;
+    generatedAt: string;
+    summary: {
+        activeIncidentsCount: number;
+        criticalCount: number;
+        resolvedLast24hCount: number;
+        monitoredRulesCount: number;
+    };
+    rules: AnomalyRule[];
+    incidents: AnomalyIncident[];
+}
+export declare class SmartAlertsAnomalyPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    private rules;
+    private incidents;
+    constructor();
+    private seedDefaults;
+    init(_context: PluginContext): Promise<void>;
+    getReport(projectId: string): SmartAlertsReport;
+    detectAnomaly(metric: AnomalyMetric, currentVal: number, historicalValues: number[]): {
+        isAnomaly: boolean;
+        zScore: number;
+        expectedRange: {
+            min: number;
+            max: number;
+        };
+    };
+    addRule(rule: Omit<AnomalyRule, "id" | "createdAt">): AnomalyRule;
+    toggleRule(ruleId: string, enabled: boolean): boolean;
+    updateIncidentStatus(incidentId: string, status: "acknowledged" | "resolved"): AnomalyIncident | null;
+}

package/dist/plugins/sql-cohort/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * LynxSEO - SqlCohort Plugin (côté moteur)
+ * Validation et agrégation des requêtes SQL construites côté client par le
+ * Query Builder (`apps/lynx-seo/src/db/sql-query-builder.ts`). Le moteur ne
+ * duplique PAS le générateur SQL : il valide la structure, borne les LIMIT,
+ * dédoublonne les filtres et garde un journal par site pour l'audit.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type SqlAggregation = "count" | "count_distinct" | "sum" | "avg" | "min" | "max";
+export type SqlGranularity = "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+/** Miroir du `QueryFilter` côté app (8 opérateurs, same shape). */
+export interface PluginQueryFilter {
+    field: string;
+    operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains" | "not_contains" | "in" | "not_in";
+    value: string | number | string[] | number[];
+    logic?: "AND" | "OR";
+}
+/** Miroir du `CohortDefinition` côté app. */
+export interface PluginCohortDefinition {
+    name: string;
+    condition: PluginQueryFilter;
+    period: "day" | "week" | "month";
+    metric: "retention" | "conversion" | "revenue" | "engagement";
+}
+export interface BuiltCohortQuery {
+    sql: string;
+    aggregation: SqlAggregation;
+    timeColumn?: string;
+    granularity?: SqlGranularity;
+    cohort?: PluginCohortDefinition;
+}
+export interface SqlCohortIssue {
+    field: "sql" | "aggregation" | "granularity" | "cohort" | "filters";
+    message: string;
+}
+export interface SqlCohortRecord {
+    id: string;
+    siteId: string;
+    createdAt: string;
+    query: BuiltCohortQuery;
+}
+export declare class SqlCohortService {
+    private records;
+    private sequence;
+    /**
+     * Valide une requête construite côté client. Retourne la liste des
+     * problèmes ; une liste vide signifie « exécutable ».
+     */
+    validate(query: BuiltCohortQuery): SqlCohortIssue[];
+    /** Valide puis journalise une requête. Lève si invalide. */
+    submit(siteId: string, query: BuiltCohortQuery): SqlCohortRecord;
+    list(siteId?: string): SqlCohortRecord[];
+    get(recordId: string): SqlCohortRecord | undefined;
+    delete(recordId: string): boolean;
+    count(siteId?: string): number;
+    clear(): void;
+}
+export declare class SqlCohortPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    validate(query: BuiltCohortQuery): SqlCohortIssue[];
+    submit(siteId: string, query: BuiltCohortQuery): SqlCohortRecord;
+    list(siteId?: string): SqlCohortRecord[];
+    get(recordId: string): SqlCohortRecord | undefined;
+    delete(recordId: string): boolean;
+    count(siteId?: string): number;
+    reset(): void;
+}
+export default SqlCohortPlugin;

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

@@ -0,0 +1,97 @@
+/**
+ * LynxSEO - Surveys Plugin (côté moteur)
+ * Définition des enquêtes et agrégation des réponses collectées par le
+ * tracker. Complète `src/survey-builder.ts` (rendu widget) et le store Pulse
+ * de l'app (PulseSurveyContract) : ici la couverture est la couche plugin
+ * branchée sur le bus d'événements.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type SurveyPluginTriggerMode = "page_view" | "exit_intent" | "event" | "scroll_depth" | "page_views" | "manual";
+export interface SurveyPluginQuestion {
+    id: string;
+    type: "text" | "scale" | "choice" | "nps";
+    label: string;
+    required: boolean;
+    options?: string[];
+}
+export interface SurveyPluginDefinition {
+    id: string;
+    siteId: string;
+    title: string;
+    description?: string;
+    status: "draft" | "running" | "paused";
+    trigger: SurveyPluginTriggerMode;
+    /** Nom d'événement attendu quand `trigger` vaut `event` (`*` = tous). */
+    triggerEvent?: string;
+    /** Seuil de défilement en pourcentage pour `scroll_depth`. */
+    scrollDepthPercent: number;
+    /** Pages vues dans la session avant affichage pour `page_views`. */
+    minPageViews: number;
+    questions: SurveyPluginQuestion[];
+    createdAt: string;
+}
+export interface SurveyPluginAnswer {
+    questionId: string;
+    value: string | number;
+}
+export interface SurveyPluginResponse {
+    id: string;
+    siteId: string;
+    surveyId: string;
+    visitorId?: string;
+    sessionId?: string;
+    pageUrl?: string;
+    answers: SurveyPluginAnswer[];
+    submittedAt: string;
+}
+export interface SurveyPluginStats {
+    surveyId: string;
+    responses: number;
+    /** Par question : moyenne pour scale/nps, distribution pour choice. */
+    perQuestion: Array<{
+        questionId: string;
+        type: SurveyPluginQuestion["type"];
+        average: number | null;
+        distribution: Record<string, number>;
+    }>;
+}
+export declare class SurveysService {
+    private surveys;
+    private responses;
+    private sequence;
+    create(input: Omit<SurveyPluginDefinition, "createdAt" | "status" | "scrollDepthPercent" | "minPageViews"> & Partial<Pick<SurveyPluginDefinition, "status" | "scrollDepthPercent" | "minPageViews" | "createdAt">>): SurveyPluginDefinition;
+    get(surveyId: string): SurveyPluginDefinition | undefined;
+    list(siteId?: string): SurveyPluginDefinition[];
+    update(surveyId: string, patch: Partial<Omit<SurveyPluginDefinition, "id" | "siteId" | "createdAt">>): SurveyPluginDefinition;
+    delete(surveyId: string): boolean;
+    record(siteId: string, input: Omit<SurveyPluginResponse, "id" | "siteId" | "submittedAt"> & {
+        id?: string;
+        submittedAt?: string;
+    }): SurveyPluginResponse;
+    responsesFor(surveyId: string): SurveyPluginResponse[];
+    count(surveyId: string): number;
+    stats(surveyId: string): SurveyPluginStats;
+    clear(): void;
+}
+export declare class SurveysPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    create(input: Omit<SurveyPluginDefinition, "createdAt" | "status" | "scrollDepthPercent" | "minPageViews"> & Partial<Pick<SurveyPluginDefinition, "status" | "scrollDepthPercent" | "minPageViews" | "createdAt">>): SurveyPluginDefinition;
+    get(surveyId: string): SurveyPluginDefinition | undefined;
+    list(siteId?: string): SurveyPluginDefinition[];
+    update(surveyId: string, patch: Partial<Omit<SurveyPluginDefinition, "id" | "siteId" | "createdAt">>): SurveyPluginDefinition;
+    delete(surveyId: string): boolean;
+    record(siteId: string, input: Omit<SurveyPluginResponse, "id" | "siteId" | "submittedAt"> & {
+        id?: string;
+        submittedAt?: string;
+    }): SurveyPluginResponse;
+    responsesFor(surveyId: string): SurveyPluginResponse[];
+    count(surveyId: string): number;
+    stats(surveyId: string): SurveyPluginStats;
+    reset(): void;
+}
+export default SurveysPlugin;

package/dist/plugins/system-diagnostics/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SystemDiagnostics Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo Core : Plugin Diagnostics (System Check, Server Check, Database Integrity, Cron checks)
+ * - PostHog Platform : Instance Status / Preflight Checks (Async migrations, Redis queues, ClickHouse health)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export type DiagnosticStatus = "healthy" | "warning" | "critical";
+export interface DiagnosticCheckItem {
+    id: string;
+    name: string;
+    category: "database" | "event_bus" | "runtime" | "storage" | "security_network";
+    status: DiagnosticStatus;
+    value: string;
+    expected: string;
+    latencyMs?: number;
+    message: string;
+    remediation?: string;
+}
+export interface SystemHealthReport {
+    overallStatus: DiagnosticStatus;
+    healthScore: number;
+    summary: {
+        totalChecks: number;
+        healthy: number;
+        warnings: number;
+        critical: number;
+    };
+    checks: DiagnosticCheckItem[];
+    environment: {
+        runtime: "edge_cloudflare" | "node_server" | "hybrid";
+        timestamp: string;
+        uptimeSeconds: number;
+        memoryAllocatedMb?: number;
+    };
+    recommendations: string[];
+}
+export interface DiagnosticOptions {
+    d1Available?: boolean;
+    d1LatencyMs?: number;
+    hyperdriveAvailable?: boolean;
+    hyperdriveLatencyMs?: number;
+    clickhouseAvailable?: boolean;
+    clickhouseLatencyMs?: number;
+    redisStreamsAvailable?: boolean;
+    redisLatencyMs?: number;
+    pendingEventsCount?: number;
+    r2StorageBound?: boolean;
+    kvDistributedLocksBound?: boolean;
+    authMode?: string;
+    httpsActive?: boolean;
+    runtime?: "edge_cloudflare" | "node_server" | "hybrid";
+}
+export declare class SystemDiagnosticsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    enable(_ctx: PluginContext): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+    /**
+     * Exécute une suite de diagnostics complets sur l'infrastructure Pulse / LynxSEO
+     */
+    runDiagnostics(opts?: DiagnosticOptions): SystemHealthReport;
+}