@lynxflow/seo-engine 1.8.29 → 2.0.0

package/src/social-video-seo.ts

@@ -1,100 +0,0 @@
-/**
- * 🎬 Video & Social SEO Analytics Engine (YouTube, TikTok, Instagram Reels)
- *
- * Tracks video rankings in Google Video Carousels and YouTube/TikTok Search,
- * measures search attribution, and generates Google-compliant Schema.org `VideoObject` graphs.
- */
-
-export interface TrackedVideoRecord {
-  id: string;
-  platform: "youtube" | "tiktok" | "instagram-reels";
-  title: string;
-  videoUrl: string;
-  thumbnailUrl: string;
-  views: number;
-  likes: number;
-  shares: number;
-  commentsCount: number;
-  durationSec: number;
-  publishedAt: string;
-  targetKeywords: string[];
-  googleVideoCarouselRank?: number; // e.g. #1 in Google Video Carousel
-  youtubeSearchRank?: number;
-  tiktokSearchRank?: number;
-  associatedLandingPageUrl?: string;
-  estimatedSearchVisitsGenerated: number;
-}
-
-export interface VideoSchemaOpts {
-  name: string;
-  description: string;
-  thumbnailUrl: string;
-  uploadDate: string;
-  contentUrl: string;
-  embedUrl: string;
-  durationIso: string; // e.g. "PT1M45S"
-  transcript?: string;
-  chapters?: { name: string; startOffsetSeconds: number }[];
-}
-
-export class SocialVideoSeoAnalyticsEngine {
-  /**
-   * Generates a Google-verified Schema.org `VideoObject` with chapters (Clip / SeekToAction).
-   */
-  static buildVideoObjectSchema(opts: VideoSchemaOpts): Record<string, unknown> {
-    const schema: Record<string, unknown> = {
-      "@context": "https://schema.org",
-      "@type": "VideoObject",
-      name: opts.name,
-      description: opts.description,
-      thumbnailUrl: [opts.thumbnailUrl],
-      uploadDate: opts.uploadDate,
-      contentUrl: opts.contentUrl,
-      embedUrl: opts.embedUrl,
-      duration: opts.durationIso,
-      transcript: opts.transcript,
-    };
-
-    if (opts.chapters && opts.chapters.length > 0) {
-      schema.hasPart = opts.chapters.map((ch, idx) => ({
-        "@type": "Clip",
-        name: ch.name,
-        startOffset: ch.startOffsetSeconds,
-        endOffset:
-          idx < opts.chapters!.length - 1
-            ? opts.chapters![idx + 1].startOffsetSeconds
-            : ch.startOffsetSeconds + 30,
-        url: `${opts.contentUrl}?t=${ch.startOffsetSeconds}`,
-      }));
-    }
-
-    return schema;
-  }
-
-  /**
-   * Analyzes an array of videos to calculate total social reach and search traffic attribution.
-   */
-  static calculateVideoPortfolioStats(videos: TrackedVideoRecord[]) {
-    const totalViews = videos.reduce((acc, v) => acc + v.views, 0);
-    const totalEngagement = videos.reduce((acc, v) => acc + (v.likes + v.shares + v.commentsCount), 0);
-    const inGoogleCarouselCount = videos.filter((v) => Boolean(v.googleVideoCarouselRank)).length;
-    const totalSearchVisits = videos.reduce((acc, v) => acc + v.estimatedSearchVisitsGenerated, 0);
-
-    const platformBreakdown = {
-      youtube: videos.filter((v) => v.platform === "youtube").length,
-      tiktok: videos.filter((v) => v.platform === "tiktok").length,
-      instagram: videos.filter((v) => v.platform === "instagram-reels").length,
-    };
-
-    return {
-      totalVideosTracked: videos.length,
-      totalViews,
-      totalEngagement,
-      avgEngagementRate: totalViews > 0 ? Math.round((totalEngagement / totalViews) * 1000) / 10 : 0,
-      inGoogleCarouselCount,
-      totalSearchVisits,
-      platformBreakdown,
-      topPerformingVideos: [...videos].sort((a, b) => b.views - a.views).slice(0, 5),
-    };
-  }
-}

package/src/team-rbac.ts

@@ -1,61 +0,0 @@
-/**
- * 👥 Team IAM & Multi-User RBAC Engine (Issue #87)
- *
- * Provides granular permissions per team member across SEO projects:
- * - `owner`: Full project control, billing, domain deletion.
- * - `admin`: Add/remove tracked keywords, run crawls, edit AI prompts.
- * - `editor`: View rankings, generate pSEO pages, run audits.
- * - `viewer`: Read-only access to dashboards and CSV exports.
- */
-
-export type TeamRole = "owner" | "admin" | "editor" | "viewer";
-
-export type PermissionAction =
-  | "project:delete"
-  | "project:update"
-  | "keywords:add"
-  | "keywords:delete"
-  | "keywords:export"
-  | "audit:run"
-  | "pseo:generate"
-  | "ai_copilot:execute";
-
-const ROLE_PERMISSIONS: Record<TeamRole, PermissionAction[]> = {
-  owner: [
-    "project:delete",
-    "project:update",
-    "keywords:add",
-    "keywords:delete",
-    "keywords:export",
-    "audit:run",
-    "pseo:generate",
-    "ai_copilot:execute",
-  ],
-  admin: [
-    "project:update",
-    "keywords:add",
-    "keywords:delete",
-    "keywords:export",
-    "audit:run",
-    "pseo:generate",
-    "ai_copilot:execute",
-  ],
-  editor: [
-    "keywords:add",
-    "keywords:export",
-    "audit:run",
-    "pseo:generate",
-    "ai_copilot:execute",
-  ],
-  viewer: ["keywords:export"],
-};
-
-export class TeamRbacEngine {
-  /**
-   * Checks if a user role has permission to perform an action.
-   */
-  static can(role: TeamRole, action: PermissionAction): boolean {
-    const permissions = ROLE_PERMISSIONS[role] || [];
-    return permissions.includes(action);
-  }
-}

package/src/technical-rules-auditor.ts

@@ -1,171 +0,0 @@
-/**
- * 🔬 Technical SEO Rules Auditor (Inspiration: seonaut/internal/issues/)
- *
- * Implements strict, production-grade automated checks:
- * 1. Heading Hierarchy Integrity (Missing H1, Multiple H1s, Hierarchy Gaps like H1->H3)
- * 2. Redirect Chain & Loop Detection (301/302 > 1 hop)
- * 3. Thin Content Detection (< 300 words)
- * 4. Canonical URL Auditing (Missing, relative, mismatched)
- * 5. Hreflang Symmetrical Validation (Missing return tags)
- * 6. Image Optimization (Missing Alt text, heavy assets > 100KB)
- */
-
-export interface PageAuditInput {
-  url: string;
-  statusCode: number;
-  headings: { tag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"; text: string }[];
-  wordCount: number;
-  canonicalUrl?: string;
-  hreflangs?: { lang: string; url: string }[];
-  images?: { src: string; alt?: string; sizeBytes?: number }[];
-  redirectChain?: { url: string; statusCode: number }[];
-  timeToFirstByteMs?: number;
-}
-
-export type IssueSeverity = "critical" | "warning" | "info";
-
-export interface TechnicalIssue {
-  code: string;
-  category: "headings" | "redirects" | "content" | "canonical" | "hreflang" | "images" | "performance";
-  severity: IssueSeverity;
-  title: string;
-  description: string;
-  recommendation: string;
-}
-
-export class TechnicalRulesAuditor {
-  /**
-   * Audits a single page payload across all technical rules.
-   */
-  static auditPage(page: PageAuditInput): TechnicalIssue[] {
-    const issues: TechnicalIssue[] = [];
-
-    // 1. Heading Hierarchy Audit
-    const h1s = page.headings.filter((h) => h.tag === "h1");
-    if (h1s.length === 0) {
-      issues.push({
-        code: "HEADING_H1_MISSING",
-        category: "headings",
-        severity: "critical",
-        title: "Balise <h1> manquante",
-        description: `Aucune balise <h1> trouvée sur ${page.url}.`,
-        recommendation: "Ajoutez exactement une balise <h1> contenant votre mot-clé principal.",
-      });
-    } else if (h1s.length > 1) {
-      issues.push({
-        code: "HEADING_H1_MULTIPLE",
-        category: "headings",
-        severity: "warning",
-        title: "Multiples balises <h1> détectées",
-        description: `La page contient ${h1s.length} balises <h1>.`,
-        recommendation: "Conservez une seule balise <h1> principale et convertissez les autres en <h2>.",
-      });
-    }
-
-    // Check heading hierarchy gaps (e.g. H1 followed immediately by H3 without H2)
-    for (let i = 0; i < page.headings.length - 1; i++) {
-      const currentLevel = parseInt(page.headings[i].tag.replace("h", ""), 10);
-      const nextLevel = parseInt(page.headings[i + 1].tag.replace("h", ""), 10);
-      if (nextLevel - currentLevel > 1) {
-        issues.push({
-          code: "HEADING_HIERARCHY_GAP",
-          category: "headings",
-          severity: "warning",
-          title: "Saut dans la hiérarchie des titres",
-          description: `Passage direct de <${page.headings[i].tag}> à <${page.headings[i + 1].tag}> sans niveau intermédiaire.`,
-          recommendation: "Respectez l'arborescence logique des titres (H1 ➔ H2 ➔ H3).",
-        });
-        break;
-      }
-    }
-
-    // 2. Redirect Chain & Loop Audit
-    if (page.redirectChain && page.redirectChain.length > 1) {
-      const isLoop = new Set(page.redirectChain.map((r) => r.url)).size < page.redirectChain.length;
-      if (isLoop) {
-        issues.push({
-          code: "REDIRECT_LOOP",
-          category: "redirects",
-          severity: "critical",
-          title: "Boucle de redirection infinie",
-          description: `Boucle de redirection détectée sur ${page.url}.`,
-          recommendation: "Corrigez la configuration de redirection pour pointer directement vers l'URL finale.",
-        });
-      } else {
-        issues.push({
-          code: "REDIRECT_CHAIN",
-          category: "redirects",
-          severity: "warning",
-          title: "Chaîne de redirection (> 1 saut)",
-          description: `La redirection traverse ${page.redirectChain.length} étapes successives.`,
-          recommendation: "Redirigez directement de l'URL initiale vers la destination finale en 1 seul saut 301.",
-        });
-      }
-    }
-
-    // 3. Thin Content Detection (< 300 words)
-    if (page.wordCount < 300 && page.statusCode === 200) {
-      issues.push({
-        code: "CONTENT_THIN",
-        category: "content",
-        severity: "critical",
-        title: "Contenu trop faible (Thin Content)",
-        description: `La page ne contient que ${page.wordCount} mots (seuil minimum recommandé : 300 mots).`,
-        recommendation: "Enrichissez la page avec du contenu textuel informatif, FAQs et preuves sociales.",
-      });
-    }
-
-    // 4. Canonical Auditing
-    if (!page.canonicalUrl && page.statusCode === 200) {
-      issues.push({
-        code: "CANONICAL_MISSING",
-        category: "canonical",
-        severity: "warning",
-        title: "Balise canonique manquante",
-        description: `Aucune balise <link rel="canonical"> n'est déclarée.`,
-        recommendation: "Ajoutez une URL canonique absolue pointant vers la version officielle de la page.",
-      });
-    }
-
-    // 5. Image Optimization & Alt Attributes
-    if (page.images) {
-      const missingAlts = page.images.filter((img) => !img.alt || img.alt.trim() === "");
-      if (missingAlts.length > 0) {
-        issues.push({
-          code: "IMAGES_ALT_MISSING",
-          category: "images",
-          severity: "warning",
-          title: "Images sans texte alternatif (alt)",
-          description: `${missingAlts.length} image(s) n'ont pas d'attribut alt renseigné.`,
-          recommendation: "Renseignez des descriptions textuelles précises pour l'accessibilité et Google Images.",
-        });
-      }
-
-      const heavyImages = page.images.filter((img) => (img.sizeBytes || 0) > 100_000);
-      if (heavyImages.length > 0) {
-        issues.push({
-          code: "IMAGES_HEAVY",
-          category: "images",
-          severity: "info",
-          title: "Images trop lourdes (> 100 KB)",
-          description: `${heavyImages.length} image(s) dépassent 100 KB.`,
-          recommendation: "Convertissez vos images au format moderne WebP / AVIF et compressez-les.",
-        });
-      }
-    }
-
-    // 6. Time To First Byte (TTFB)
-    if (page.timeToFirstByteMs && page.timeToFirstByteMs > 500) {
-      issues.push({
-        code: "PERF_HIGH_TTFB",
-        category: "performance",
-        severity: "warning",
-        title: "Temps de réponse serveur élevé (TTFB > 500ms)",
-        description: `Le TTFB mesuré est de ${page.timeToFirstByteMs}ms.`,
-        recommendation: "Activez la mise en cache Edge CDN (Cloudflare) ou l'ISR Next.js pour passer sous 50ms.",
-      });
-    }
-
-    return issues;
-  }
-}

package/src/token-quota-manager.ts

@@ -1,91 +0,0 @@
-/**
- * 🪙 Token Quota & Credit Billing Bridge
- * 
- * Synchronizes with LynxFlow's official TokenBillingService & CreditService (1$ = 100 credits).
- * Manages tenant monthly quotas, OpenRouter raw provider costs, and credit balances.
- */
-
-export interface TokenUsageRecord {
-  promptTokens: number;
-  completionTokens: number;
-  totalTokens: number;
-  creditsCharged: number;
-  model: string;
-  timestamp: string;
-}
-
-export interface CreditQuotaStatus {
-  tier: "starter" | "growth" | "enterprise";
-  monthlyCreditBudget: number; // e.g. 5,000 credits ($50) for Growth, 50,000 credits ($500) for Enterprise
-  usedCredits: number;
-  remainingCredits: number;
-  isQuotaExceeded: boolean;
-}
-
-export class TokenQuotaManager {
-  private tier: "starter" | "growth" | "enterprise";
-  private monthlyCreditBudget: number;
-  private usedCredits: number = 0;
-
-  constructor(tier: "starter" | "growth" | "enterprise" = "enterprise") {
-    this.tier = tier;
-    this.monthlyCreditBudget = this.resolveBudget(tier);
-  }
-
-  private resolveBudget(tier: "starter" | "growth" | "enterprise"): number {
-    switch (tier) {
-      case "enterprise":
-        return 50_000; // 50,000 credits ($500/mo)
-      case "growth":
-        return 5_000;  // 5,000 credits ($50/mo)
-      case "starter":
-      default:
-        return 500;    // 500 credits ($5/mo)
-    }
-  }
-
-  /**
-   * Records token usage and calculates LynxFlow Credit cost (1$ = 100 credits).
-   * Only charges credits when AI call succeeds (Issue #222 fix).
-   */
-  consumeTokens(
-    promptTokens: number,
-    completionTokens: number,
-    model: string,
-    rawProviderCostUsd = 0.002, // Default ~$0.002 per 1k tokens
-  ): TokenUsageRecord {
-    const totalTokens = promptTokens + completionTokens;
-    
-    // LynxFlow standard: Provider cost + 20% margin converted to credits (1$ = 100cr)
-    const costWithMarginUsd = rawProviderCostUsd * (totalTokens / 1000) * 1.2;
-    const creditsCharged = Math.max(1, Math.ceil(costWithMarginUsd * 100));
-
-    this.usedCredits += creditsCharged;
-
-    if (this.usedCredits > this.monthlyCreditBudget) {
-      console.warn(`⚠️ [LynxFlow Credit Quota] Monthly credit budget exceeded (${this.usedCredits} / ${this.monthlyCreditBudget} cr). Switching to zero-cost algorithmic mode.`);
-    }
-
-    return {
-      promptTokens,
-      completionTokens,
-      totalTokens,
-      creditsCharged,
-      model,
-      timestamp: new Date().toISOString(),
-    };
-  }
-
-  /**
-   * Gets current credit quota status.
-   */
-  getStatus(): CreditQuotaStatus {
-    return {
-      tier: this.tier,
-      monthlyCreditBudget: this.monthlyCreditBudget,
-      usedCredits: this.usedCredits,
-      remainingCredits: Math.max(0, this.monthlyCreditBudget - this.usedCredits),
-      isQuotaExceeded: this.usedCredits >= this.monthlyCreditBudget,
-    };
-  }
-}

package/src/types.ts

@@ -1,143 +0,0 @@
-/**
- * 🌟 Types & Interfaces for @lynxflow/seo-engine Universal SDK
- * 
- * Full Institutional pSEO Type System matching LynxFlow's 8 Programmatic Matrices:
- * 1. 📍 Local & GEO : [Pillar/Service] × [City/Country]
- * 2. 🥊 VS & Comparatifs : [Brand/Service] vs [Competitor]
- * 3. 🔄 Alternatives : [Competitor] ➔ [Brand/Service]
- * 4. 🏢 Secteurs & Métiers : [Service] × [Industry Vertical] (with localized ROI)
- * 5. 🔌 Intégrations : [Service] × [Third-party Software]
- * 6. 👤 Personas & Décideurs : [Service] × [Decision Maker Role]
- * 7. 🎯 Cas d'Usage : [Problem Statement] ➔ [AI Workflow Solution]
- * 8. 🧮 Simulateurs & Outils : Interactive ROI & Time-Savings Calculators
- */
-
-export interface LynxServiceDefinition {
-  slug: string;
-  name: string;
-  description?: string;
-  pricePerMonth: number;
-  category?: string;
-  features?: string[];
-  faqs?: { question: string; answer: string }[];
-}
-
-import type {
-  PseoIndustry,
-  PseoCompetitor,
-  PseoIntegration,
-  PseoUseCase,
-  PseoPersona,
-  PseoService,
-  PseoLocation,
-  PseoCalculator,
-} from "./matrix-engine";
-
-export type {
-  PseoIndustry,
-  PseoCompetitor,
-  PseoIntegration,
-  PseoUseCase,
-  PseoPersona,
-  PseoService,
-  PseoLocation,
-  PseoCalculator,
-};
-
-export interface PseoCity {
-  slug: string;
-  name: string;
-  region: string;
-  country: string;
-  department?: string;
-  densityTier?: "major" | "secondary" | "regional";
-}
-
-export interface PseoCountry {
-  code: string;
-  name: string;
-  currency: string;
-  currencySymbol: string;
-  locale: string;
-  economicMultiplier: number;
-}
-
-export interface LynxSeoConfig {
-  apiKey?: string;
-  licenseKey?: string; // Deprecated: use apiKey
-  domain: string;
-  brandName: string;
-  category?: string;
-  defaultLocale?: string;
-  supportedLocales?: string[];
-  currency?: string;
-  currencySymbol?: string;
-  services: LynxServiceDefinition[];
-  industries?: PseoIndustry[];
-  competitors?: PseoCompetitor[];
-  integrations?: PseoIntegration[];
-  personas?: PseoPersona[];
-  useCases?: PseoUseCase[];
-  cities?: PseoCity[];
-  locations?: PseoLocation[];
-  phone?: string;
-}
-
-export interface LynxResolvedPage {
-  url: string;
-  title: string;
-  description: string;
-  h1: string;
-  directAnswer: string;
-  locale?: string;
-  hreflangs?: { lang: string; url: string }[];
-  faqs: { question: string; answer: string }[];
-  jsonLd: Record<string, unknown>;
-  htmlBody: string;
-  markdownBody: string;
-  executionTimeMs: number;
-
-  // Localized ROI data (when applicable)
-  localizedRoi?: {
-    monthlySavingsFormatted: string;
-    hoursSavedWeekly: number;
-    annualSavingsFormatted: string;
-    currencySymbol: string;
-  };
-
-  // Structured component data
-  service?: LynxServiceDefinition;
-  industry?: PseoIndustry;
-  competitor?: PseoCompetitor;
-  integration?: PseoIntegration;
-
-  meta?: {
-    title: string;
-    description: string;
-    h1: string;
-    canonical: string;
-    openGraphImageUrl?: string;
-  };
-
-  // Backward compatibility convenience fields
-  fullUrl?: string;
-  schemaJsonLd?: Record<string, unknown>;
-  content?: {
-    directAnswerGeoHtml?: string;
-    heroHeadline?: string;
-    heroSubheadline?: string;
-    markdownBody?: string;
-    faqList?: { question: string; answer: string }[];
-  };
-  pricing?: {
-    priceNumber?: number;
-    priceFormatted?: string;
-    currency?: string;
-  };
-
-  debug?: {
-    licenseStatus?: "active" | "trial" | "expired" | "offline_mode";
-    generationMs?: number;
-    matrixType?: string;
-  };
-}