@lynxflow/seo-engine 2.8.0 → 3.2.1

package/dist/plugins/queued-tracking/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * LynxSEO - Queued Tracking Plugin
+ * Inspiré de Matomo QueuedTracking (GPLv3 / AGPLv3 compatible).
+ *
+ * File d'attente d'ingestion avec backpressure : les requêtes de tracking sont
+ * mises en file par lot (Redis Streams côté LynxSEO), et le plugin contrôle la
+ * taille de file, la taille de lot et le taux de rejet pour protéger l'ingestion.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface QueueConfig {
+    /** Nombre maximal d'événements en file avant rejet (backpressure). */
+    maxQueueSize: number;
+    /** Taille de lot consommée par le worker. */
+    batchSize: number;
+    /** Nombre maximal de files parallèles (numQueueWorkers Matomo). */
+    workers: number;
+}
+export interface QueueState {
+    size: number;
+    capacity: number;
+    utilization: number;
+    batches: number;
+    dropped: number;
+    /** true quand la file a dépassé le seuil de capacité. */
+    saturated: boolean;
+}
+export interface QueueMetrics {
+    enqueued: number;
+    dequeued: number;
+    dropped: number;
+    peakSize: number;
+    averageSize: number;
+    rejectionRate: number;
+}
+export declare const DEFAULT_QUEUE_CONFIG: QueueConfig;
+export declare class QueuedTrackingPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    private config;
+    private queues;
+    private stats;
+    constructor(config?: Partial<QueueConfig>);
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /** Consomme un lot d'événements (le worker les traite ensuite). */
+    dequeue(siteId: string, size?: number): PluginEvent[];
+    /** Nombre de lots nécessaires pour vider la file avec les workers configurés. */
+    getPendingBatches(siteId: string): number;
+    getState(siteId: string): QueueState;
+    getMetrics(siteId: string): QueueMetrics;
+    getConfig(): QueueConfig;
+    configure(patch: Partial<QueueConfig>): QueueConfig;
+    reset(siteId: string): void;
+    disable(): Promise<void>;
+    private getMetricsInternal;
+}
+export default QueuedTrackingPlugin;

package/dist/plugins/real-time-usage/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Real-Time Usage Plugin (Inspiré de PostHog Real-Time Usage & Surge Protection)
+ *
+ * Fournit une surveillance en direct du débit d'ingestion des événements,
+ * la détection des pics soudains (bursts/spikes), l'estimation des coûts/volumes projetés
+ * et un mécanisme de disjoncteur (circuit-breaker / dynamic sampling) pour protéger l'infrastructure.
+ */
+import type { LynxSeoPlugin, PluginManifest, PluginContext } from "../../plugin/types";
+export interface EventThroughputPoint {
+    timestamp: string;
+    eventsPerSecond: number;
+    eventsPerMinute: number;
+    byteThroughputKbps: number;
+    isSpike: boolean;
+}
+export interface EventTypeBreakdown {
+    eventName: string;
+    count: number;
+    percentage: number;
+    estimatedPayloadKb: number;
+}
+export interface CircuitBreakerStatus {
+    status: "normal" | "warning" | "tripped_sampling";
+    currentThroughputRatio: number;
+    maxEventsPerMinuteThreshold: number;
+    samplingRate: number;
+    lastTrippedAt: string | null;
+    tripReason: string | null;
+}
+export interface MonthlyVolumeProjection {
+    currentMonthEvents: number;
+    planQuotaEvents: number;
+    daysElapsed: number;
+    daysInMonth: number;
+    projectedMonthEndEvents: number;
+    quotaConsumptionPercent: number;
+    isProjectedToExceed: boolean;
+}
+export interface RealTimeUsageReport {
+    projectId: string;
+    generatedAt: string;
+    circuitBreaker: CircuitBreakerStatus;
+    projection: MonthlyVolumeProjection;
+    topEvents: EventTypeBreakdown[];
+    history: EventThroughputPoint[];
+    totalEventsLastHour: number;
+    averageEventsPerSecond: number;
+    peakEventsPerSecond: number;
+}
+export declare class RealTimeUsagePlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    private maxThresholdPerMinute;
+    private samplingActive;
+    private currentSamplingRate;
+    private lastTripTimestamp;
+    private lastTripReason;
+    init(_context: PluginContext): Promise<void>;
+    setThreshold(maxEventsPerMinute: number): void;
+    setSamplingRate(rate: number): void;
+    resetCircuitBreaker(): void;
+    triggerSpikeProtection(reason: string, emergencySamplingRate?: number): void;
+    calculateUsageReport(projectId: string, options?: {
+        currentMonthEvents?: number;
+        planQuota?: number;
+        eventsLastHour?: number;
+    }): RealTimeUsageReport;
+}

package/dist/plugins/referrer-brand-enricher/index.d.ts

@@ -0,0 +1 @@
+export * from "./referrer-brand-enricher";

package/dist/plugins/referrer-brand-enricher/referrer-brand-enricher.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ReferrerBrandEnricherPlugin — Résolution, enrichissement de marque et classification des referrers
+ *
+ * Inspiré de Rybbit (favicon & domain resolver), de Matomo (moteurs de recherche & réseaux sociaux)
+ * et du Channel Classifier d'Umami.
+ *
+ * Implémentation Clean-Room indépendante sous licence AGPL-3.0.
+ */
+import type { LynxSeoPlugin, PluginManifest } from "../../plugin/types";
+export type ReferrerCategory = "SEARCH_ENGINE" | "AI_ASSISTANT" | "SOCIAL" | "TECH_COMMUNITY" | "EMAIL" | "INTERNAL" | "DIRECT" | "OTHER_REFERRAL";
+export interface EnrichedReferrer {
+    rawUrl?: string;
+    domain?: string;
+    name: string;
+    category: ReferrerCategory;
+    badgeColor: string;
+    iconSlug: string;
+    isAiSource: boolean;
+    extractedQuery?: string;
+}
+export interface ReferrerCategoryStat {
+    category: ReferrerCategory;
+    categoryLabel: string;
+    count: number;
+    sharePct: number;
+}
+export interface ReferrerSourceStat {
+    name: string;
+    domain: string;
+    category: ReferrerCategory;
+    badgeColor: string;
+    iconSlug: string;
+    count: number;
+    sharePct: number;
+    isAiSource: boolean;
+}
+export interface ReferrerDistributionReport {
+    totalReferrals: number;
+    categories: ReferrerCategoryStat[];
+    topSources: ReferrerSourceStat[];
+    aiTrafficSharePct: number;
+    organicSearchSharePct: number;
+    socialSharePct: number;
+    generatedAt: string;
+}
+export declare class ReferrerBrandEnricherPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    readonly id = "referrer-brand-enricher";
+    readonly name = "Referrer Brand & Search Engine Catalog Enricher";
+    readonly version = "1.0.0";
+    /**
+     * Résout et enrichit une URL de referrer
+     */
+    enrich(referrerUrl?: string, targetDomain?: string): EnrichedReferrer;
+    /**
+     * Analyse une distribution de referrers
+     */
+    enrichBatch(referrers: string[], targetDomain?: string): ReferrerDistributionReport;
+}

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

@@ -0,0 +1,14 @@
+import { type TrafficChannel } from "../../traffic-attribution";
+import type { LynxSeoPlugin, PluginContext, PluginEvent, PluginManifest } from "../../plugin/types";
+export interface ReferrerStat {
+    channel: TrafficChannel | "direct";
+    visits: number;
+}
+export declare class ReferrersPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private readonly bySite;
+    enable(_ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    getStats(siteId: string): ReferrerStat[];
+}
+export default ReferrersPlugin;

package/dist/plugins/referrers-complet/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * LynxSEO - Referrers Complet Plugin
+ * Analyse détaillée des référents (sources de trafic, campagnes, mots-clés, domaines).
+ * Inspiré de Matomo Referrers (GPLv3 / AGPLv3 compatible).
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ReferrerEntry {
+    id: string;
+    siteId: string;
+    source: string;
+    medium: string;
+    campaign?: string;
+    keyword?: string;
+    visits: number;
+    conversions: number;
+    firstSeen: string;
+    lastSeen: string;
+}
+export declare class ReferrersService {
+    private referrers;
+    record(entry: Partial<ReferrerEntry> & {
+        siteId: string;
+        source: string;
+        medium: string;
+    }): ReferrerEntry;
+    get(siteId: string, source: string, medium: string): ReferrerEntry | undefined;
+    list(siteId?: string): ReferrerEntry[];
+    topByVisits(siteId?: string, limit?: number): ReferrerEntry[];
+    byMedium(siteId?: string): Record<string, ReferrerEntry[]>;
+    count(siteId?: string): number;
+    clear(): void;
+}
+export declare class ReferrersCompletPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(_ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    record(entry: Partial<ReferrerEntry> & {
+        siteId: string;
+        source: string;
+        medium: string;
+    }): ReferrerEntry;
+    get(siteId: string, source: string, medium: string): ReferrerEntry | undefined;
+    list(siteId?: string): ReferrerEntry[];
+    topByVisits(siteId?: string, limit?: number): ReferrerEntry[];
+    byMedium(siteId?: string): Record<string, ReferrerEntry[]>;
+    count(siteId?: string): number;
+    reset(): void;
+}
+export default ReferrersCompletPlugin;

package/dist/plugins/registry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Registre des plugins de rapports analytics.
+ *
+ * Un seul endroit instancie les plugins exposés par `/api/analytics/plugins/*` :
+ * le bootstrap serveur charge cette liste, et le catalogue client doit rester
+ * aligné dessus (test de couverture). Les clés historiques (`overlay`,
+ * `devicesDetection`, `geoip`, `transitions`, `ecommerce`, `userLanguage`,
+ * `referrers`, `leads`) sont conservées telles quelles pour ne pas casser les
+ * routes déjà branchées.
+ */
+import { ActionsPlugin } from "./actions";
+import { AIAgentsPlugin } from "./ai-agents";
+import { AnnotationsPlugin } from "./annotations";
+import { BandwidthPlugin } from "./bandwidth";
+import { BotTrackingPlugin } from "./bot-tracking";
+import { BulkTrackingPlugin } from "./bulk-tracking";
+import { ContentsPlugin } from "./contents";
+import { CustomAlertsPlugin } from "./custom-alerts";
+import { CustomDimensionsPlugin } from "./custom-dimensions";
+import { CustomJsTrackerPlugin } from "./custom-js-tracker";
+import { CustomVariablesPlugin } from "./custom-variables";
+import { DashboardWidgetsPlugin } from "./dashboard-widgets";
+import { DevicesDetectionPlugin } from "./devices-detection";
+import { EcommercePlugin } from "./ecommerce";
+import { EventsPlugin } from "./events";
+import { ExperimentsPlugin } from "./experiments";
+import { FeedbackPlugin } from "./feedback";
+import { GeoIpPlugin } from "./geoip";
+import { GoalsPlugin } from "./goals";
+import { HeartbeatPlugin } from "./heartbeat";
+import { InsightsPlugin } from "./insights";
+import { JsTrackerInstallCheckPlugin } from "./js-tracker-install-check";
+import { LeadsPlugin } from "./leads";
+import { LivePlugin } from "./live";
+import { LiveDetailedPlugin } from "./live-detailed";
+import { MarketingCampaignsPlugin } from "./marketing-campaigns";
+import { MultiSitesPlugin } from "./multi-sites";
+import { OverlayPlugin } from "./overlay";
+import { RUMPlugin } from "./page-performance";
+import { PrivacyManagerPlugin } from "./privacy-manager";
+import { QueuedTrackingPlugin } from "./queued-tracking";
+import { ReferrersPlugin } from "./referrers";
+import { ReferrersCompletPlugin } from "./referrers-complet";
+import { ReplayPlugin } from "./replay";
+import { ResolutionPlugin } from "./resolution";
+import { ScheduledReportsPlugin } from "./scheduled-reports";
+import { SegmentEditorPlugin } from "./segment-editor";
+import { SqlCohortPlugin } from "./sql-cohort";
+import { SurveysPlugin } from "./surveys";
+import { TagManagerPlugin } from "./tag-manager";
+import { TrackingSpamPreventionPlugin } from "./tracking-spam-prevention";
+import { TransitionsPlugin } from "./transitions";
+import { UserCountryMapPlugin } from "./user-country-map";
+import { UserIdPlugin } from "./user-id";
+import { UserLanguagePlugin } from "./user-language";
+import { UsersManagerPlugin } from "./users-manager";
+import { VisitFrequencyPlugin } from "./visit-frequency";
+import { VisitTimePlugin } from "./visit-time";
+import { VisitorInterestPlugin } from "./visitor-interest";
+/** Tous les plugins de rapports, une instance par identifiant de catalogue. */
+export declare function createReportPlugins(): {
+    overlay: OverlayPlugin;
+    devicesDetection: DevicesDetectionPlugin;
+    geoip: GeoIpPlugin;
+    transitions: TransitionsPlugin;
+    ecommerce: EcommercePlugin;
+    userLanguage: UserLanguagePlugin;
+    referrers: ReferrersPlugin;
+    leads: LeadsPlugin;
+    userCountryMap: UserCountryMapPlugin;
+    resolution: ResolutionPlugin;
+    visitFrequency: VisitFrequencyPlugin;
+    visitorInterest: VisitorInterestPlugin;
+    visitTime: VisitTimePlugin;
+    userId: UserIdPlugin;
+    referrersComplet: ReferrersCompletPlugin;
+    marketingCampaigns: MarketingCampaignsPlugin;
+    contents: ContentsPlugin;
+    actions: ActionsPlugin;
+    events: EventsPlugin;
+    goals: GoalsPlugin;
+    live: LivePlugin;
+    liveDetailed: LiveDetailedPlugin;
+    heartbeat: HeartbeatPlugin;
+    aiAgents: AIAgentsPlugin;
+    experiments: ExperimentsPlugin;
+    surveys: SurveysPlugin;
+    replay: ReplayPlugin;
+    customVariables: CustomVariablesPlugin;
+    customDimensions: CustomDimensionsPlugin;
+    rum: RUMPlugin;
+    bandwidth: BandwidthPlugin;
+    bots: BotTrackingPlugin;
+    spamPrevention: TrackingSpamPreventionPlugin;
+    insights: InsightsPlugin;
+    customAlerts: CustomAlertsPlugin;
+    multiSites: MultiSitesPlugin;
+    segmentEditor: SegmentEditorPlugin;
+    sqlCohort: SqlCohortPlugin;
+    queuedTracking: QueuedTrackingPlugin;
+    bulkTracking: BulkTrackingPlugin;
+    customJsTracker: CustomJsTrackerPlugin;
+    installCheck: JsTrackerInstallCheckPlugin;
+    scheduledReports: ScheduledReportsPlugin;
+    feedback: FeedbackPlugin;
+    annotations: AnnotationsPlugin;
+    dashboardWidgets: DashboardWidgetsPlugin;
+    usersManager: UsersManagerPlugin;
+    tagManager: TagManagerPlugin;
+    privacyManager: PrivacyManagerPlugin;
+};
+export type ReportPlugins = ReturnType<typeof createReportPlugins>;

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

@@ -0,0 +1,64 @@
+/**
+ * LynxSEO - Replay Plugin (côté moteur)
+ * Suivi des sessions de replay (chunks rrweb) ingérés par
+ * `/api/pulse/v1/replay` (ingestion TS, persistance R2/KV, masquage et
+ * plafond de 5 min appliqués côté serveur). Le plugin n'ingère PAS les
+ * chunks : il agrège les métadonnées de session exposées au dashboard
+ * (durée, taille, pages, statut) et met à jour le statut de traitement.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type ReplayChunkStatus = "pending" | "processing" | "stored" | "failed";
+export interface ReplaySessionSummary {
+    sessionId: string;
+    siteId: string;
+    visitorId?: string;
+    projectId?: string;
+    chunksReceived: number;
+    chunksExpected: number | null;
+    eventsCount: number;
+    bytes: number;
+    firstChunkAt: string;
+    lastChunkAt: string;
+    durationMs: number;
+    status: ReplayChunkStatus;
+    error?: string;
+}
+export interface ReplaySiteStats {
+    sessions: number;
+    chunks: number;
+    events: number;
+    bytes: number;
+    averageDurationMs: number;
+    failedSessions: number;
+}
+export declare class ReplayService {
+    private sessions;
+    private key;
+    get(siteId: string, sessionId: string): ReplaySessionSummary | undefined;
+    list(siteId: string, limit?: number): ReplaySessionSummary[];
+    count(siteId: string): number;
+    stats(siteId: string): ReplaySiteStats;
+    /** Événement `tracker.replay.chunk` : enregistre/met à jour une session. */
+    recordChunk(siteId: string, payload: Record<string, unknown>, at: Date): ReplaySessionSummary;
+    markFailed(siteId: string, sessionId: string, error: string): boolean;
+    markStored(siteId: string, sessionId: string): boolean;
+    delete(siteId: string, sessionId: string): boolean;
+    clear(): void;
+}
+export declare class ReplayPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private service;
+    private ctx?;
+    enable(ctx: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    get(siteId: string, sessionId: string): ReplaySessionSummary | undefined;
+    list(siteId: string, limit?: number): ReplaySessionSummary[];
+    count(siteId: string): number;
+    stats(siteId: string): ReplaySiteStats;
+    markFailed(siteId: string, sessionId: string, error: string): boolean;
+    markStored(siteId: string, sessionId: string): boolean;
+    delete(siteId: string, sessionId: string): boolean;
+    reset(): void;
+}
+export default ReplayPlugin;

package/dist/plugins/replay-vision/index.d.ts

@@ -0,0 +1,45 @@
+import type { LynxSeoPlugin, PluginManifest, PluginContext } from "../../plugin/types";
+export type SessionOutcome = "converted" | "abandoned" | "error_exit" | "exploring";
+export interface SessionVisionAnalysis {
+    sessionId: string;
+    userId?: string;
+    durationSeconds: number;
+    frustrationScore: number;
+    outcome: SessionOutcome;
+    signals: {
+        rageClicksCount: number;
+        deadClicksCount: number;
+        mouseThrashingCount: number;
+        navigationLoopsCount: number;
+        jsErrorsCount: number;
+    };
+    summaryText: string;
+    keySteps: string[];
+    recommendation: string;
+    analyzedAt: string;
+}
+export interface ReplayVisionReport {
+    projectId: string;
+    generatedAt: string;
+    summary: {
+        analyzedSessionsCount: number;
+        averageFrustrationScore: number;
+        highFrustrationRate: number;
+        topFrustrationFactor: string;
+    };
+    analyses: SessionVisionAnalysis[];
+}
+export declare class ReplayVisionPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    private analyses;
+    constructor();
+    private seedDefaultAnalyses;
+    init(_context: PluginContext): Promise<void>;
+    getReport(projectId: string): ReplayVisionReport;
+    analyzeSession(params: {
+        sessionId: string;
+        userId?: string;
+        durationSeconds: number;
+        signals: SessionVisionAnalysis["signals"];
+    }): SessionVisionAnalysis;
+}

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

@@ -0,0 +1,49 @@
+/**
+ * LynxSEO - Resolution Plugin
+ * Inspiré de Matomo Resolution (GPLv3 / AGPLv3 compatible).
+ *
+ * Répartition des visites par résolution d'écran et par configuration
+ * (wide screen, écran normal). Matomo considère une résolution "wide screen"
+ * à partir de 1280 pixels de large.
+ */
+import { LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export interface ResolutionRow {
+    resolution: string;
+    width: number;
+    height: number;
+    hits: number;
+    percentage: number;
+}
+export interface ConfigurationRow {
+    label: string;
+    hits: number;
+    percentage: number;
+}
+export interface ResolutionStats {
+    resolutions: ResolutionRow[];
+    configurations: ConfigurationRow[];
+    totalVisits: number;
+    averageWidth: number;
+    averageHeight: number;
+}
+/** Seuil Matomo : au-delà, l'écran est considéré comme wide screen. */
+export declare const WIDE_SCREEN_MIN_WIDTH = 1280;
+export declare class ResolutionPlugin implements LynxSeoPlugin {
+    readonly manifest: PluginManifest;
+    private ctx?;
+    /** siteId → `${width}x${height}` → hits */
+    private resolutions;
+    enable(ctx: PluginContext): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    /** Matomo Resolution.getResolution. */
+    getResolution(siteId: string, limit?: number): ResolutionRow[];
+    /** Matomo Resolution.getConfiguration : wide screen vs standard. */
+    getConfiguration(siteId: string): ConfigurationRow[];
+    /** Matomo Resolution.getWideScreen : uniquement les visites wide screen. */
+    getWideScreen(siteId: string, limit?: number): ResolutionRow[];
+    getStats(siteId: string): ResolutionStats;
+    reset(siteId: string): void;
+    disable(): Promise<void>;
+    private totalVisits;
+}
+export default ResolutionPlugin;

package/dist/plugins/resource-transfer/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * LynxSEO - Resource Transfer & Project Portability Plugin
+ * Clean-room implementation inspirée de PostHog Inter-Project Resource Transfer & Data Portability.
+ * Conforme AGPLv3.
+ *
+ * Permet de transférer, copier et exporter/importer des ressources analytiques complètes
+ * (Tableaux de bord, Insights, Cohortes, Actions, Fonctions Hog, Alertes, Schémas de Taxonomie)
+ * entre projets et organisations, avec résolution des dépendances, vérification d'intégrité et gestion des conflits.
+ */
+import { type LynxSeoPlugin, type PluginManifest, type PluginContext, type PluginEvent } from "../../plugin/types";
+export type TransferableResourceType = "dashboard" | "insight" | "cohort" | "action" | "hog_function" | "custom_alert" | "taxonomy_schema";
+export type TransferConflictStrategy = "skip" | "overwrite" | "rename_copy";
+export interface TransferableResource {
+    id: string;
+    type: TransferableResourceType;
+    name: string;
+    description?: string;
+    dependsOn?: string[];
+    payload: Record<string, any>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ResourceTransferBundle {
+    id: string;
+    name: string;
+    sourceProjectId: string;
+    sourceOrganizationId: string;
+    exportedAt: string;
+    author: string;
+    checksum: string;
+    resources: TransferableResource[];
+}
+export interface TransferPreviewResult {
+    bundleId: string;
+    totalResources: number;
+    toCreate: number;
+    toOverwrite: number;
+    toSkip: number;
+    toRename: number;
+    missingDependencies: string[];
+    resolvedItems: Array<{
+        originalId: string;
+        type: TransferableResourceType;
+        name: string;
+        action: "create" | "overwrite" | "skip" | "rename";
+        newName?: string;
+    }>;
+}
+export interface TransferExecutionRecord {
+    id: string;
+    bundleId: string;
+    targetProjectId: string;
+    targetOrganizationId: string;
+    conflictStrategy: TransferConflictStrategy;
+    status: "success" | "partial" | "failed";
+    itemsProcessed: number;
+    itemsCreated: number;
+    itemsOverwritten: number;
+    itemsSkipped: number;
+    itemsRenamed: number;
+    executedAt: string;
+    executedBy: string;
+}
+export declare class ResourceTransferPlugin implements LynxSeoPlugin {
+    manifest: PluginManifest;
+    private context?;
+    private inventory;
+    private bundles;
+    private executionHistory;
+    constructor();
+    enable(context: PluginContext): Promise<void>;
+    disable(): Promise<void>;
+    onEvent(event: PluginEvent): Promise<void>;
+    private seedSampleInventory;
+    listAvailableResources(): TransferableResource[];
+    /**
+     * Calcule transitivement toutes les dépendances d'un ensemble de ressources
+     */
+    resolveDependencies(selectedIds: string[]): TransferableResource[];
+    /**
+     * Crée un bundle exportable autonome avec checksum
+     */
+    createExportBundle(name: string, resourceIds: string[], author?: string): ResourceTransferBundle;
+    listBundles(): ResourceTransferBundle[];
+    getBundle(id: string): ResourceTransferBundle | null;
+    /**
+     * Prévisualise l'importation d'un bundle dans un projet cible
+     */
+    previewTransfer(bundleId: string, conflictStrategy?: TransferConflictStrategy): TransferPreviewResult | null;
+    /**
+     * Exécute le transfert effectif vers le projet
+     */
+    executeTransfer(bundleId: string, targetProjectId: string, targetOrganizationId: string, conflictStrategy?: TransferConflictStrategy, executedBy?: string): TransferExecutionRecord | null;
+    listExecutionHistory(): TransferExecutionRecord[];
+}