@lynxflow/seo-engine 2.8.0 → 3.2.1

package/dist/plugins/content-treemap/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ContentTreemap Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo CoreVisualizations / TreemapVisualization : Visualisation arborescente et surfaces proportionnelles
+ * - PostHog Content Taxonomy : Découpage hiérarchique par répertoire et détection de friction
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export interface ContentTreemapNode {
+    path: string;
+    name: string;
+    depth: number;
+    pageviews: number;
+    uniqueVisitors: number;
+    avgTimeOnPageSeconds: number;
+    bounceRatePercent: number;
+    seoHealthScore: number;
+    children: ContentTreemapNode[];
+    isLeafPage?: boolean;
+}
+export interface ContentTreemapReport {
+    siteId: string;
+    totalPageviews: number;
+    totalPagesCount: number;
+    rootNode: ContentTreemapNode;
+    underperformingSections: Array<{
+        path: string;
+        pageviews: number;
+        bounceRatePercent: number;
+        issue: string;
+    }>;
+    topPerformingSections: Array<{
+        path: string;
+        pageviews: number;
+        healthScore: number;
+    }>;
+    recommendations: string[];
+}
+export declare class ContentTreemapPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private context?;
+    private pagesBySite;
+    enable(ctx: PluginContext): void;
+    onEvent(event: PluginEvent): void;
+    recordPageView(siteId: string, urlPath: string, visitorId: string, durationSeconds?: number, isBounce?: boolean): void;
+    getStats(siteId: string): ContentTreemapReport;
+    getReport(siteId: string): ContentTreemapReport;
+    private normalizeUrlPath;
+    private getDefaultReport;
+}

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

@@ -0,0 +1,42 @@
+/**
+ * LynxSEO - Contents Plugin (Content Tracking & Impressions)
+ * Inspiré de Matomo Contents (GPLv3 / AGPLv3 compatible).
+ *
+ * Suit les impressions et interactions sur les contenus (bannières, CTA, embeds)
+ * et calcule le taux d'interaction par contenu.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ContentImpression {
+    contentName: string;
+    contentPiece: string;
+    contentTarget: string;
+    siteId: string;
+    timestamp: string;
+}
+export interface ContentInteraction {
+    contentName: string;
+    contentPiece: string;
+    contentInteraction: string;
+    siteId: string;
+    timestamp: string;
+}
+export interface ContentStats {
+    contentName: string;
+    impressions: number;
+    interactions: number;
+    interactionRate: number;
+}
+export declare class ContentsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private impressions;
+    private interactions;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Récupère les stats par contenu (impressions, interactions, taux).
+     */
+    getStats(siteId?: string): ContentStats[];
+    disable(): Promise<void>;
+}
+export default ContentsPlugin;

package/dist/plugins/correlation-analysis/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CorrelationAnalysis Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - PostHog Funnels : Correlation Analysis / Event & Property Drivers
+ * - Identification automatique des événements clés corrélés au succès (conversion) ou à l'échec (churn/drop)
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export interface CorrelationFactor {
+    id: string;
+    name: string;
+    type: "event" | "property";
+    correlationType: "success" | "failure";
+    oddsRatio: number;
+    correlationScore: number;
+    convertedUsersWithFactor: number;
+    droppedUsersWithFactor: number;
+    totalUsersWithFactor: number;
+    significance: "very_high" | "high" | "medium" | "low";
+    description: string;
+}
+export interface CorrelationAnalysisReport {
+    siteId: string;
+    targetGoal: string;
+    analyzedUsersCount: number;
+    conversionRatePercent: number;
+    positiveDrivers: CorrelationFactor[];
+    negativeDrivers: CorrelationFactor[];
+    summary: string;
+}
+export declare class CorrelationAnalysisPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private context?;
+    private userEvents;
+    enable(ctx: PluginContext): void;
+    onEvent(event: PluginEvent): void;
+    recordEvent(siteId: string, userId: string, eventName: string, isConversion?: boolean): void;
+    getStats(siteId: string): CorrelationAnalysisReport;
+    getReport(siteId: string, targetGoal?: string): CorrelationAnalysisReport;
+    private getDefaultReport;
+}

package/dist/plugins/custom-alerts/index.d.ts

@@ -0,0 +1,22 @@
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin/types";
+export interface CustomAlertRule {
+    id: string;
+    metric: string;
+    threshold: number;
+}
+export interface TriggeredAlert extends CustomAlertRule {
+    siteId: string;
+    value: number;
+    triggeredAt: string;
+}
+export declare class CustomAlertsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private readonly rules;
+    private readonly alerts;
+    enable(_ctx: PluginContext): Promise<void>;
+    registerRule(rule: CustomAlertRule): void;
+    onEvent(event: PluginEvent): Promise<void>;
+    getTriggeredAlerts(siteId: string): TriggeredAlert[];
+    disable(): Promise<void>;
+}
+export default CustomAlertsPlugin;

package/dist/plugins/custom-dimensions/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LynxSEO - Custom Dimensions Plugin
+ * Inspiré de Matomo CustomDimensions (GPLv3 / AGPLv3 compatible).
+ *
+ * Dimensions personnalisées avec scope (visit/action/event), extraction par regex,
+ * jusqu'à 5 dimensions par site.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+import { type CustomDimensionDef } from "../../custom-dimensions";
+export interface CustomDimensionsConfig {
+    siteId: string;
+    dimensions: Array<Omit<CustomDimensionDef, "id" | "siteId">>;
+}
+export declare class CustomDimensionsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private configs;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Enregistre une nouvelle dimension personnalisée pour un site.
+     */
+    registerDimension(siteId: string, def: Omit<CustomDimensionDef, "id" | "siteId">): number;
+    /**
+     * Récupère les définitions de dimensions d'un site.
+     */
+    getDimensions(siteId: string): CustomDimensionDef[];
+    /**
+     * Récupère une définition par ID.
+     */
+    getDimension(siteId: string, dimensionId: number): CustomDimensionDef | undefined;
+    /**
+     * Déclare une config complète pour un site (batch).
+     */
+    configure(siteId: string, dimensions: Array<Omit<CustomDimensionDef, "id" | "siteId">>): void;
+    disable(): Promise<void>;
+}
+export default CustomDimensionsPlugin;

package/dist/plugins/custom-js-tracker/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * LynxSEO - Custom JS Tracker Plugin
+ * Inspiré de Matomo CustomJsTracker (GPLv3 / AGPLv3 compatible).
+ *
+ * Personnalisation du script de tracking servi aux sites : nom du fichier,
+ * version exposée, endpoint d'ingestion et surcharges de configuration
+ * injectées dans le tracker.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface CustomTrackerConfig {
+    /** Nom public du script (ex: "lynx.js"). */
+    filename: string;
+    /** Espace de noms global exposé au navigateur (ex: "_lynx"). */
+    namespace: string;
+    /** Version injectée dans le script. */
+    version: string;
+    /** URL absolue de l'endpoint d'ingestion. */
+    endpoint: string;
+    /** Désactive le pixel image de secours. */
+    disableImageBeacon: boolean;
+    /** Respecte Do Not Track côté client. */
+    respectDoNotTrack: boolean;
+}
+export interface TrackerSnippet {
+    filename: string;
+    namespace: string;
+    version: string;
+    endpoint: string;
+    /** Balise HTML prête à coller dans le site. */
+    snippet: string;
+}
+export declare const DEFAULT_TRACKER_CONFIG: CustomTrackerConfig;
+export declare class CustomJsTrackerPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private configs;
+    enable(ctx: PluginContext): Promise<void>;
+    /** Configure le tracker d'un site. */
+    configure(siteId: string, patch: Partial<CustomTrackerConfig>): CustomTrackerConfig;
+    getConfig(siteId: string): CustomTrackerConfig;
+    reset(siteId: string): void;
+    /** Snippet d'installation correspondant à la configuration du site. */
+    getSnippet(siteId: string, siteUrl?: string): TrackerSnippet;
+    /** Contenu du fichier de configuration servi au tracker. */
+    getTrackerFile(siteId: string, siteUrl?: string): string;
+    disable(): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+}
+export default CustomJsTrackerPlugin;

package/dist/plugins/custom-variables/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * LynxSEO - Custom Variables Plugin
+ * Inspiré de Matomo Custom Variables (GPLv3 / AGPLv3 compatible).
+ *
+ * Paires clé/valeur flexibles par visite, scope visit/action.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface CustomVariable {
+    index: number;
+    name: string;
+    value: string;
+    scope: "visit" | "action";
+    /** Renseigné par le flux d'événements : une variable appartient à un site. */
+    siteId?: string;
+}
+export interface CustomVariableSet {
+    visitorId: string;
+    siteId: string;
+    variables: CustomVariable[];
+}
+export declare class CustomVariablesPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private variables;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Définit une variable personnalisée pour un visiteur.
+     */
+    setVariable(visitorId: string, index: number, name: string, value: string, scope?: "visit" | "action"): void;
+    /**
+     * Récupère une variable par index.
+     */
+    getVariable(visitorId: string, index: number): CustomVariable | undefined;
+    /**
+     * Récupère toutes les variables d'un visiteur.
+     */
+    getVariables(visitorId: string): CustomVariable[];
+    /**
+     * Supprime toutes les variables d'un visiteur (RGPD).
+     */
+    deleteVisitorVariables(visitorId: string): void;
+    /**
+     * Distribution des paires nom/valeur pour un site : combien de visiteurs
+     * portent chaque valeur. C'est la lecture agrégée qu'un rapport peut
+     * afficher ; les valeurs brutes restent indexées par visiteur.
+     */
+    getDistribution(siteId: string): Array<{
+        name: string;
+        value: string;
+        scope: "visit" | "action";
+        visitors: number;
+        occurrences: number;
+    }>;
+    disable(): Promise<void>;
+}
+export default CustomVariablesPlugin;

package/dist/plugins/dashboard-presets/dashboard-presets.d.ts

@@ -0,0 +1,51 @@
+/**
+ * DashboardPresetsPlugin — Modèles de tableaux de bord prêts à l'emploi et bibliothèque de presets
+ *
+ * Inspiré de PostHog Template Library, de Matomo Dashboard Marketplace
+ * et des Starters Metabase.
+ *
+ * Implémentation Clean-Room indépendante sous licence AGPL-3.0.
+ */
+import type { LynxSeoPlugin, PluginManifest } from "../../plugin/types";
+export type DashboardPresetCategory = "SEO" | "ECOMMERCE" | "PRODUCT_SAAS" | "TECH_PERF" | "AI_DISCOVERY";
+export type PresetWidgetType = "metric" | "chart_line" | "chart_bar" | "funnel" | "table" | "heatmap";
+export interface PresetWidgetDefinition {
+    id: string;
+    title: string;
+    type: PresetWidgetType;
+    metricKey: string;
+    width: "full" | "half" | "third";
+    description?: string;
+}
+export interface DashboardPresetDefinition {
+    id: string;
+    title: string;
+    description: string;
+    category: DashboardPresetCategory;
+    categoryLabel: string;
+    badge: string;
+    iconSlug: string;
+    widgets: PresetWidgetDefinition[];
+    isBuiltin: boolean;
+}
+export interface InstantiatedDashboard {
+    id: string;
+    presetId: string;
+    title: string;
+    category: DashboardPresetCategory;
+    widgetsCount: number;
+    widgets: PresetWidgetDefinition[];
+    createdAt: string;
+}
+export declare class DashboardPresetsPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    readonly id = "dashboard-presets";
+    readonly name = "Dashboard Templates & Presets Library";
+    readonly version = "1.0.0";
+    private presets;
+    constructor();
+    listPresets(category?: DashboardPresetCategory): DashboardPresetDefinition[];
+    getPreset(id: string): DashboardPresetDefinition | undefined;
+    registerCustomPreset(preset: DashboardPresetDefinition): void;
+    instantiate(presetId: string, customTitle?: string): InstantiatedDashboard;
+}

package/dist/plugins/dashboard-presets/index.d.ts

@@ -0,0 +1 @@
+export * from "./dashboard-presets";

package/dist/plugins/dashboard-widgets/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * LynxSEO - Dashboard Widgets Plugin
+ * Widgets personnalisables pour les tableaux de bord (métriques, graphiques, listes).
+ * Inspiré de Matomo Dashboard Widgets (GPLv3 / AGPLv3 compatible).
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface DashboardWidget {
+    id: string;
+    siteId: string;
+    name: string;
+    type: "metric" | "chart" | "list" | "table";
+    config: Record<string, any>;
+    position: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WidgetLayout {
+    siteId: string;
+    widgets: DashboardWidget[];
+}
+export declare class DashboardWidgetsService {
+    private widgets;
+    create(widget: Omit<DashboardWidget, "id" | "createdAt" | "updatedAt"> & {
+        id?: string;
+    }): DashboardWidget;
+    get(widgetId: string): DashboardWidget | undefined;
+    list(siteId?: string): DashboardWidget[];
+    update(widgetId: string, patch: Partial<DashboardWidget>): DashboardWidget | undefined;
+    delete(widgetId: string): boolean;
+    count(siteId?: string): number;
+    clear(): void;
+}
+export declare class DashboardWidgetsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(_ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    create(widget: Omit<DashboardWidget, "id" | "createdAt" | "updatedAt"> & {
+        id?: string;
+    }): DashboardWidget;
+    get(widgetId: string): DashboardWidget | undefined;
+    list(siteId?: string): DashboardWidget[];
+    update(widgetId: string, patch: Partial<DashboardWidget>): DashboardWidget | undefined;
+    delete(widgetId: string): boolean;
+    count(siteId?: string): number;
+    reset(): void;
+}
+export default DashboardWidgetsPlugin;

package/dist/plugins/data-quality/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * DataQuality Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - PostHog Platform : Data Quality & Schema Integrity ($event_definitions, détection des propriétés manquantes, alertes de types mutants, surveillance des événements non répertoriés)
+ * - Matomo Core : Intégrité et assainissement des tables de tracking
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export type QualityIssueSeverity = "warning" | "error" | "info";
+export type QualityIssueType = "unknown_event" | "null_property" | "type_mismatch" | "high_cardinality" | "missing_distinct_id" | "invalid_timestamp";
+export interface QualityIssue {
+    id: string;
+    eventName: string;
+    propertyName?: string;
+    issueType: QualityIssueType;
+    message: string;
+    severity: QualityIssueSeverity;
+    count: number;
+    lastSeen: string;
+}
+export interface EventQualitySummary {
+    eventName: string;
+    totalEvents: number;
+    validEvents: number;
+    issuesCount: number;
+    complianceRate: number;
+    samplePayload?: Record<string, string | number | boolean | null>;
+}
+export interface DataQualityReport {
+    siteId: string;
+    overallQualityScore: number;
+    totalEventsAudited: number;
+    compliantEventsCount: number;
+    flaggedEventsCount: number;
+    activeIssues: QualityIssue[];
+    eventSummaries: EventQualitySummary[];
+    recommendations: string[];
+}
+export declare class DataQualityPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private context?;
+    private issuesBySite;
+    private statsByEvent;
+    private readonly STANDARD_EVENTS;
+    enable(ctx: PluginContext): void;
+    onEvent(event: PluginEvent): void;
+    auditEvent(siteId: string, eventName: string, payload: Record<string, unknown>, userId?: string, timestamp?: string): void;
+    private registerIssue;
+    getStats(siteId: string): DataQualityReport;
+    getReport(siteId: string, options?: {
+        search?: string;
+        severity?: QualityIssueSeverity;
+    }): DataQualityReport;
+    private getDefaultReport;
+}

package/dist/plugins/data-warehouse/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * LynxSEO - Data Warehouse Saved Queries & Materialized Views Plugin
+ * Clean-room implementation inspirée de PostHog Data Warehouse & Matomo Custom SQL Reporting.
+ * Conforme AGPLv3.
+ *
+ * Permet de définir, synchroniser et matérialiser des requêtes analytiques persistantes,
+ * d'inférer le schéma des colonnes et de monitorer la fraîcheur et la taille des tables virtuelles.
+ */
+import { type LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type WarehouseSourceType = "events" | "postgres" | "s3_parquet" | "stripe_webhook" | "custom_federation";
+export type WarehouseSyncFrequency = "realtime" | "hourly" | "daily" | "weekly" | "manual";
+export type WarehouseViewStatus = "active" | "syncing" | "paused" | "failed";
+export type WarehouseColumnType = "string" | "integer" | "float" | "boolean" | "datetime" | "json";
+export interface WarehouseColumnSchema {
+    name: string;
+    type: WarehouseColumnType;
+    nullable?: boolean;
+}
+export interface DataWarehouseView {
+    id: string;
+    siteId: string;
+    name: string;
+    description: string;
+    query: string;
+    sourceType: WarehouseSourceType;
+    syncFrequency: WarehouseSyncFrequency;
+    columns: WarehouseColumnSchema[];
+    status: WarehouseViewStatus;
+    lastSyncedAt?: string;
+    rowCount: number;
+    byteSize: number;
+    durationMs: number;
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MaterializationJob {
+    id: string;
+    viewId: string;
+    viewName: string;
+    status: "pending" | "running" | "completed" | "failed";
+    startedAt: string;
+    finishedAt?: string;
+    durationMs?: number;
+    rowsProduced: number;
+    bytesProcessed: number;
+    error?: string;
+}
+export interface DataWarehouseReport {
+    siteId: string;
+    views: DataWarehouseView[];
+    totalViews: number;
+    activeViews: number;
+    totalRowsMaterialized: number;
+    totalSizeBytes: number;
+    avgDurationMs: number;
+    recentJobs: MaterializationJob[];
+    generatedAt: string;
+}
+export declare class DataWarehousePlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private views;
+    private jobs;
+    constructor();
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /**
+     * Crée une nouvelle vue matérialisée dans le Data Warehouse
+     */
+    createView(params: {
+        siteId: string;
+        name: string;
+        description?: string;
+        query: string;
+        sourceType?: WarehouseSourceType;
+        syncFrequency?: WarehouseSyncFrequency;
+    }): DataWarehouseView;
+    /**
+     * Met à jour une vue matérialisée
+     */
+    updateView(id: string, updates: Partial<Pick<DataWarehouseView, "name" | "description" | "query" | "syncFrequency" | "status" | "sourceType">>): DataWarehouseView | null;
+    /**
+     * Supprime une vue matérialisée
+     */
+    deleteView(id: string): boolean;
+    /**
+     * Déclenche la matérialisation synchrone ou asynchrone d'une vue
+     */
+    runMaterialization(viewId: string): MaterializationJob | null;
+    /**
+     * Récupère le rapport complet pour un site donné
+     */
+    getReport(siteId: string): DataWarehouseReport;
+    /**
+     * Analyse statique heuristique d'une requête SQL/HogQL pour extraire les colonnes
+     */
+    private inferColumnsFromQuery;
+    private seedDefaultViews;
+}

package/dist/plugins/db-stats/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * DBStats Plugin — LynxSEO Engine
+ *
+ * Parité fonctionnelle :
+ * - Matomo Core : Plugin DBStats (mesure taille tables, lignes, espace par site, archivage)
+ * - PostHog Data Warehouse : Storage analytics & Database health overview
+ *
+ * Licence : AGPL-3.0-or-later
+ */
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin";
+export interface TableMetric {
+    tableName: string;
+    category: "raw_events" | "sessions" | "replays" | "heatmaps" | "outbox" | "metadata";
+    estimatedRows: number;
+    dataSizeBytes: number;
+    indexSizeBytes: number;
+    totalSizeBytes: number;
+    oldestRecordAt?: string;
+    newestRecordAt?: string;
+    purgeCandidateRows: number;
+}
+export interface SiteStorageShare {
+    siteId: string;
+    siteName?: string;
+    estimatedRows: number;
+    totalSizeBytes: number;
+    percentageOfTotal: number;
+}
+export interface StorageRecommendation {
+    id: string;
+    severity: "info" | "warning" | "critical";
+    title: string;
+    description: string;
+    estimatedSavingsBytes: number;
+    actionableStep: string;
+}
+export interface DBStatsReport {
+    databaseEngine: "sqlite_d1" | "postgres_hyperdrive" | "clickhouse" | "memory";
+    totalRows: number;
+    totalSizeBytes: number;
+    totalDataSizeBytes: number;
+    totalIndexSizeBytes: number;
+    quotaSizeBytes: number;
+    usedPercentage: number;
+    healthStatus: "healthy" | "warning" | "critical";
+    tables: TableMetric[];
+    sitesDistribution: SiteStorageShare[];
+    recommendations: StorageRecommendation[];
+    retentionDaysDefault: number;
+    generatedAt: string;
+}
+export declare class DBStatsPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private engine;
+    private quotaSizeBytes;
+    private retentionDaysDefault;
+    private customTables;
+    private siteStats;
+    enable(_ctx: PluginContext): Promise<void>;
+    onEvent(_event: PluginEvent): Promise<void>;
+    constructor(options?: {
+        engine?: "sqlite_d1" | "postgres_hyperdrive" | "clickhouse" | "memory";
+        quotaSizeBytes?: number;
+        retentionDaysDefault?: number;
+    });
+    private seedDefaultTables;
+    registerTableMetric(metric: TableMetric): void;
+    recordSiteAllocation(siteId: string, rows: number, bytes: number, name?: string): void;
+    estimatePurgeSavings(retentionDays: number): {
+        recoverableBytes: number;
+        candidateRows: number;
+        tablesAffected: number;
+    };
+    getReport(filterSiteId?: string): DBStatsReport;
+}