@lynxflow/seo-engine 1.8.30 → 2.0.0

package/dist/index.js

@@ -1,4 +1,4 @@
-// packages/lynx-seo-engine/src/token-quota-manager.ts
+// src/token-quota-manager.ts
 class TokenQuotaManager {
   tier;
   monthlyCreditBudget;
@@ -35,6 +35,11 @@ class TokenQuotaManager {
       timestamp: new Date().toISOString()
     };
   }
+  consume(tokens, model = "openrouter/auto") {
+    const prompt = Math.floor(tokens * 0.6);
+    const completion = tokens - prompt;
+    return this.consumeTokens(prompt, completion, model);
+  }
   getStatus() {
     return {
       tier: this.tier,
@@ -46,7 +51,7 @@ class TokenQuotaManager {
   }
 }
 
-// packages/lynx-seo-engine/src/auth-key.ts
+// src/auth-key.ts
 class ApiKeyGuardian {
   static domainRegistry = new Map;
   static uniquePageRegistry = new Map;
@@ -220,7 +225,7 @@ class ApiKeyGuardian {
   }
 }
 
-// packages/lynx-seo-engine/src/i18n-dictionary.ts
+// src/i18n-dictionary.ts
 var DICTIONARIES = {
   fr: {
     geoTitle: (s, city, country, b) => `${s} à ${city} (${country}) — ${b}`,
@@ -576,7 +581,7 @@ function isSupportedLanguage(lang) {
   return Boolean(DICTIONARIES[code]);
 }
 
-// packages/lynx-seo-engine/src/indexnow-client.ts
+// src/indexnow-client.ts
 var SUCCESS_STATUSES = new Set([200, 202]);
 var MAX_URLS_PER_REQUEST = 1e4;
 var REQUEST_TIMEOUT_MS = 15000;
@@ -632,7 +637,7 @@ class IndexNowClient {
   }
 }
 
-// packages/lynx-seo-engine/src/analytics-client.ts
+// src/analytics-client.ts
 class LynxAnalyticsClient {
   apiKey;
   endpoint;
@@ -861,7 +866,7 @@ class LynxAnalyticsClient {
   }
 }
 
-// packages/lynx-seo-engine/src/serp-client.ts
+// src/serp-client.ts
 class SerpClient {
   apiKey;
   endpoint;
@@ -914,7 +919,7 @@ class SerpClient {
   }
 }
 
-// packages/lynx-seo-engine/src/backlinks-client.ts
+// src/backlinks-client.ts
 class BacklinksClient {
   apiKey;
   endpoint;
@@ -970,8 +975,8 @@ class BacklinksClient {
   }
 }
 
-// packages/lynx-seo-engine/src/rag-knowledge-engine.ts
-class LynxRagKnowledgeEngine2 {
+// src/rag-knowledge-engine.ts
+class LynxRagKnowledgeEngine {
   static chunkStore = new Map;
   static ingestDocument(siteId, documentName, rawText, category = "general") {
     const cleanText = rawText.replace(/\r\n/g, `
@@ -1061,7 +1066,7 @@ Directives d'analyse :
   }
 }
 
-// packages/lynx-seo-engine/src/ai-copilot-client.ts
+// src/ai-copilot-client.ts
 class AiCopilotClient {
   apiKey;
   endpoint;
@@ -1073,7 +1078,7 @@ class AiCopilotClient {
     try {
       let ragFacts = [];
       if (params.enableRag && params.siteId) {
-        const retrieved = LynxRagKnowledgeEngine2.retrieveRelevantContext(params.siteId, params.topic, 3);
+        const retrieved = LynxRagKnowledgeEngine.retrieveRelevantContext(params.siteId, params.topic, 3);
         ragFacts = retrieved.map((r) => r.chunk.content);
       }
       if (!this.apiKey || this.apiKey.startsWith("demo_")) {
@@ -1136,7 +1141,7 @@ Optimiser votre stratégie avec ${params.targetKeywords.join(", ")}.
   }
 }
 
-// packages/lynx-seo-engine/src/lago-token-meter.ts
+// src/lago-token-meter.ts
 class LagoTokenMeter {
   lagoApiUrl;
   apiKey;
@@ -1217,7 +1222,7 @@ class HyperswitchGateway {
   }
 }
 
-// packages/lynx-seo-engine/src/site-auditor.ts
+// src/site-auditor.ts
 class SiteAuditor {
   static inspectMeta(params) {
     const checks = [];
@@ -1263,7 +1268,7 @@ class SiteAuditor {
   }
 }
 
-// packages/lynx-seo-engine/src/schema-builder.ts
+// src/schema-builder.ts
 class SchemaGraphBuilder {
   static buildGraph(opts) {
     const productNode = {
@@ -1358,7 +1363,7 @@ class SchemaGraphBuilder {
   }
 }
 
-// packages/lynx-seo-engine/src/site-crawler.ts
+// src/site-crawler.ts
 class DeepCrawlerAuditor {
   static DEFAULT_USER_AGENT = "LynxFlowSeoBot/1.2 (+https://lynxintel.io/bot; technical audit)";
   static inspectHtmlSnapshot(url, html, statusCode = 200, responseTimeMs = 45) {
@@ -1647,7 +1652,7 @@ class DeepCrawlerAuditor {
   }
 }
 
-// packages/lynx-seo-engine/src/cro-copywriting-engine.ts
+// src/cro-copywriting-engine.ts
 class CroCopywritingEngine {
   static generatePasCopy(solutionName, targetNiche) {
     return {
@@ -1709,7 +1714,7 @@ class CroCopywritingEngine {
   }
 }
 
-// packages/lynx-seo-engine/src/llm-content-cleaner.ts
+// src/llm-content-cleaner.ts
 class LlmContentCleaner {
   static cleanForLlm(content) {
     return this.htmlToCleanMarkdown(content);
@@ -1737,7 +1742,7 @@ $1
   }
 }
 
-// packages/lynx-seo-engine/src/engine.ts
+// src/engine.ts
 class LynxSeoEngine {
   config;
   servicesMap;
@@ -2335,7 +2340,7 @@ ${servicesList}
 `;
   }
 }
-// packages/lynx-seo-engine/src/slug-engine.ts
+// src/slug-engine.ts
 var MULTILINGUAL_STOP_WORDS = {
   en: new Set([
     "the",
@@ -2726,7 +2731,7 @@ function validateSeoSlug(slug) {
     errors
   };
 }
-// packages/lynx-seo-engine/src/legal-disclaimers.ts
+// src/legal-disclaimers.ts
 var MULTILINGUAL_DISCLAIMERS = {
   en: {
     comparison: {
@@ -3022,7 +3027,7 @@ class LegalDisclaimerEngine {
     };
   }
 }
-// packages/lynx-seo-engine/src/extended-schemas.ts
+// src/extended-schemas.ts
 var SCHEMA_LOCAL_BUSINESS_MAP = {
   plumber: "Plumber",
   plumbing: "Plumber",
@@ -3378,7 +3383,7 @@ class ExtendedSchemaGraphBuilder {
   }
 }
 
-// packages/lynx-seo-engine/src/built-in-locations.ts
+// src/built-in-locations.ts
 var BUILT_IN_LOCATIONS_DATABASE = {
   fr: [
     { slug: "paris", name: "Paris", region: "Île-de-France", country: "France", population: 2161000, currency: "EUR", currencySymbol: "€", latitude: 48.8566, longitude: 2.3522, neighborSlugs: ["boulogne-billancourt", "saint-denis", "montreuil"] },
@@ -3521,8 +3526,50 @@ function resolveBuiltInLocations(territories) {
   }
   return results.length > 0 ? results : [...BUILT_IN_LOCATIONS_DATABASE.fr];
 }
+function createDynamicLocation(slugOrInput, fallbackCountry = "France") {
+  const cleanInput = slugOrInput.trim().toLowerCase();
+  const slug = cleanInput.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const formattedName = slug.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const isPostalCode = /^\d{4,5}$/.test(cleanInput);
+  const displayName = isPostalCode ? `Secteur ${cleanInput}` : formattedName;
+  const isUS = fallbackCountry.toLowerCase().includes("us") || fallbackCountry.toLowerCase().includes("state");
+  const isUK = fallbackCountry.toLowerCase().includes("uk") || fallbackCountry.toLowerCase().includes("kingdom");
+  return {
+    slug,
+    name: displayName,
+    region: isPostalCode ? `Département ${cleanInput.slice(0, 2)}` : "Région Métropolitaine",
+    country: fallbackCountry,
+    currency: isUS ? "USD" : isUK ? "GBP" : "EUR",
+    currencySymbol: isUS ? "$" : isUK ? "£" : "€",
+    population: 45000,
+    latitude: 48.8566,
+    longitude: 2.3522,
+    neighborSlugs: []
+  };
+}
+function resolveLocationFromHeaders(headers) {
+  const getHeader = (name) => {
+    if (!headers)
+      return;
+    if (typeof headers.get === "function") {
+      return headers.get(name) || headers.get(name.toLowerCase()) || undefined;
+    }
+    const map = headers;
+    return map[name] || map[name.toLowerCase()] || undefined;
+  };
+  const rawCity = getHeader("cf-ipcity") || getHeader("x-vercel-ip-city") || getHeader("x-geo-city");
+  const rawCountry = getHeader("cf-ipcountry") || getHeader("x-vercel-ip-country") || getHeader("x-geo-country");
+  const rawRegion = getHeader("cf-region") || getHeader("x-vercel-ip-country-region");
+  const rawPostalCode = getHeader("cf-postal-code") || getHeader("x-vercel-ip-postal-code");
+  return {
+    city: rawCity ? decodeURIComponent(rawCity) : undefined,
+    country: rawCountry ? decodeURIComponent(rawCountry) : undefined,
+    region: rawRegion ? decodeURIComponent(rawRegion) : undefined,
+    postalCode: rawPostalCode ? decodeURIComponent(rawPostalCode) : undefined
+  };
+}
 
-// packages/lynx-seo-engine/src/og-image-generator.ts
+// src/og-image-generator.ts
 class OgImageGenerator {
   static generateOgImageUrl(domain, pageMeta, brandName) {
     const cleanDomain = domain.replace(/\/+$/, "");
@@ -3603,7 +3650,7 @@ class OgImageGenerator {
   }
 }
 
-// packages/lynx-seo-engine/src/matrix-engine.ts
+// src/matrix-engine.ts
 class PseoMatrixEngine {
   legalEngine;
   constructor(legalOptions) {
@@ -4149,7 +4196,21 @@ class PseoMatrixEngine {
   resolvePage(slugOrPath, domain, data, options) {
     const path = typeof slugOrPath === "string" ? slugOrPath.startsWith("/") ? slugOrPath : `/${slugOrPath}` : `/${slugOrPath.join("/")}`;
     const pages = this.generateAllMatrices(domain, data, options);
-    return pages.find((p) => p.urlPath === path);
+    const existing = pages.find((p) => p.urlPath === path);
+    if (existing)
+      return existing;
+    const segments = path.split("/").filter(Boolean);
+    if (segments.length >= 2 && data.services && data.services.length > 0) {
+      const serviceSlug = segments[0];
+      const locationSlug = segments[segments.length - 1];
+      const matchedService = data.services.find((s) => cleanSeoSlug(s.slug, { language: options.language }) === serviceSlug || s.slug === serviceSlug);
+      if (matchedService) {
+        const dynamicLoc = createDynamicLocation(locationSlug, options.countries?.[0] || "France");
+        const dynamicPages = this.generateLocalGeoMatrix(domain, [matchedService], [dynamicLoc], options);
+        return dynamicPages.find((p) => p.urlPath === path) || dynamicPages[0];
+      }
+    }
+    return;
   }
   generateSitemapXml(domain, data, options) {
     const pages = this.generateAllMatrices(domain, data, options).filter((p) => p.robots.includes("index"));
@@ -4354,7 +4415,7 @@ Notre couverture pour **${service}** s'étend à l'ensemble du bassin économiqu
     };
   }
 }
-// packages/lynx-seo-engine/src/i18n-detector.ts
+// src/i18n-detector.ts
 var SUPPORTED_CANONICAL_LOCALES = [
   "en",
   "fr",
@@ -4431,7 +4492,7 @@ class I18nDetector {
     };
   }
 }
-// packages/lynx-seo-engine/src/brand-icons.ts
+// src/brand-icons.ts
 var BRAND_ICONS = {
   facebook: {
     name: "Facebook",
@@ -4547,7 +4608,7 @@ function renderBrandIconSvg(input, className = "w-5 h-5 inline-block") {
     return "";
   return `<svg class="${className}" viewBox="${icon.viewBox}" fill="currentColor" aria-hidden="true"><path d="${icon.svgPath}"/></svg>`;
 }
-// packages/lynx-seo-engine/src/ui-icons.ts
+// src/ui-icons.ts
 var UI_ICONS = {
   zap: {
     name: "Zap / Lightning",
@@ -4660,7 +4721,7 @@ function resolveFeatureIcon(featureText) {
   }
   return "zap";
 }
-// packages/lynx-seo-engine/src/free-public-tools.ts
+// src/free-public-tools.ts
 class FreePublicToolsEngine {
   static simulateSerpSnippet(input) {
     const title = (input.title || "").trim();
@@ -4794,7 +4855,7 @@ class FreePublicToolsEngine {
     });
   }
 }
-// packages/lynx-seo-engine/src/urlytics-engine.ts
+// src/urlytics-engine.ts
 class UrlyticsEngine {
   static parseUrl(rawUrl) {
     if (!rawUrl || typeof rawUrl !== "string") {
@@ -4856,7 +4917,7 @@ class UrlyticsEngine {
     return urls.map((u) => this.parseUrl(u));
   }
 }
-// packages/lynx-seo-engine/src/keyword-permutator.ts
+// src/keyword-permutator.ts
 class KeywordPermutatorEngine {
   static generateKeywordMatrix(options) {
     const { products, words = [], locations = [], maxCombinations = 5000 } = options;
@@ -4932,7 +4993,7 @@ class KeywordPermutatorEngine {
     return results;
   }
 }
-// packages/lynx-seo-engine/src/llm-prompt.ts
+// src/llm-prompt.ts
 var PSEO_AGENT_SYSTEM_PROMPT = `
 You are the Programmatic SEO Implementation Specialist powered by @lynxflow/seo-engine.
 Your role is to configure, resolve, and maintain programmatic SEO pages, XML sitemaps, Schema.org JSON-LD graphs, and compliance rules.
@@ -5014,15 +5075,17 @@ import { PseoMatrixEngine } from "@lynxflow/seo-engine";
 export const matrixEngine = new PseoMatrixEngine();
 
 export const SEO_CONFIG = {
-  brandName: "Acme",
-  language: "fr",
-  countries: ["france", "belgique", "suisse"], // Or "europe" / "international". The SDK automatically provides verified cities!
+  brandName: "Acme Global",
+  language: "en",
+  countries: ["united-states", "united-kingdom", "germany", "france"], // Or "international" / any country worldwide.
   cleanDirectRoutes: true, // Eliminates parasite words (/solutions/, etc.)
   minPopulationToIndex: 15_000,
 };
 
-// Discovered EXCLUSIVELY from Frontend UI components
-// NOTE: DO NOT list cities manually! The SDK auto-provisions them based on your target countries/scope.
+// \uD83C\uDF10 UNIVERSAL INTERNATIONAL RESOLUTION RULES:
+// - Supports ANY ISO-639-1 / BCP-47 language code passed dynamically at runtime (en, de, es, fr, ja, pt, ar, zh, etc.).
+// - Supports ANY city, postal code, or district worldwide via dynamic synthesis (createDynamicLocation) and real-time Edge GeoIP.
+// - DO NOT hardcode fixed city counts or language limits. The SDK resolves any valid input on the fly.
 export const PSEO_DATASET = {
   services: [
     // 1 per major frontend feature branch
@@ -5246,7 +5309,7 @@ ${PSEO_AGENT_SYSTEM_PROMPT}
 - Domain: ${customContext.domain || "https://example.com"}
 `.trim();
 }
-// packages/lynx-seo-engine/src/geo-mesh-linking.ts
+// src/geo-mesh-linking.ts
 class GeoMeshLinkingEngine {
   static computeDistanceKm(coord1, coord2) {
     const R = 6371;
@@ -5278,7 +5341,7 @@ class GeoMeshLinkingEngine {
     return sameRegion.slice(0, maxNeighbors).map((c) => ({ city: c }));
   }
 }
-// packages/lynx-seo-engine/src/brand-dna-calendar.ts
+// src/brand-dna-calendar.ts
 class BrandDnaCalendarEngine {
   static generate4WeekCalendar(dna, services, topCities = ["Paris", "Lyon", "Marseille", "Bordeaux"]) {
     const calendar = [];
@@ -5358,7 +5421,7 @@ class BrandDnaCalendarEngine {
     return calendar;
   }
 }
-// packages/lynx-seo-engine/src/technical-rules-auditor.ts
+// src/technical-rules-auditor.ts
 class TechnicalRulesAuditor {
   static auditPage(page) {
     const issues = [];
@@ -5476,7 +5539,7 @@ class TechnicalRulesAuditor {
     return issues;
   }
 }
-// packages/lynx-seo-engine/src/ai-bots-log-analyzer.ts
+// src/ai-bots-log-analyzer.ts
 class AiBotsLogAnalyzer {
   static classifyUserAgent(ua) {
     const lowerUa = ua.toLowerCase();
@@ -5547,7 +5610,7 @@ class AiBotsLogAnalyzer {
     return result;
   }
 }
-// packages/lynx-seo-engine/src/serp-history-alerts.ts
+// src/serp-history-alerts.ts
 class SerpRankHistoryEngine {
   static analyzeRankShift(previousSnapshot, currentSnapshot) {
     const prev = previousSnapshot.position;
@@ -5588,7 +5651,7 @@ class SerpRankHistoryEngine {
     return null;
   }
 }
-// packages/lynx-seo-engine/src/seo-opportunities-decay.ts
+// src/seo-opportunities-decay.ts
 class SeoOpportunitiesDecayDetector {
   static getExpectedCtr(position) {
     if (position <= 1)
@@ -5677,7 +5740,7 @@ class SeoOpportunitiesDecayDetector {
     return cannibalized;
   }
 }
-// packages/lynx-seo-engine/src/knowledge-graph-linker.ts
+// src/knowledge-graph-linker.ts
 class KnowledgeGraphLinker {
   static buildSearchUrl(query, apiKey, limit = 5, languages = ["fr", "en"]) {
     const params = new URLSearchParams({
@@ -5725,7 +5788,7 @@ class KnowledgeGraphLinker {
     return Array.from(new Set(links));
   }
 }
-// packages/lynx-seo-engine/src/mcp-seo-server.ts
+// src/mcp-seo-server.ts
 class McpSeoServerHub {
   static getRegisteredTools() {
     return [
@@ -5814,7 +5877,7 @@ class McpSeoServerHub {
     }
   }
 }
-// packages/lynx-seo-engine/src/master-marketing-engine.ts
+// src/master-marketing-engine.ts
 class MasterMarketingEngine {
   static generateDirectoryListings(domain = "lynxintel.io", brandName = "LynxSEO") {
     return [
@@ -6039,7 +6102,7 @@ class MasterMarketingEngine {
     };
   }
 }
-// packages/lynx-seo-engine/src/social-video-seo.ts
+// src/social-video-seo.ts
 class SocialVideoSeoAnalyticsEngine {
   static buildVideoObjectSchema(opts) {
     const schema = {
@@ -6087,7 +6150,7 @@ class SocialVideoSeoAnalyticsEngine {
     };
   }
 }
-// packages/lynx-seo-engine/src/social-trend-seo.ts
+// src/social-trend-seo.ts
 class SocialTrendSeoGenerator {
   static generateActionFromTrend(trend, serviceSlug = "crm-pipeline", serviceName = "CRM Pipeline Commercial") {
     const cleanTopic = trend.topicName.toLowerCase().replace(/[^a-z0-9]+/g, "-");
@@ -6147,7 +6210,7 @@ class SocialTrendSeoGenerator {
     ];
   }
 }
-// packages/lynx-seo-engine/src/crosslink-scorer.ts
+// src/crosslink-scorer.ts
 class CrosslinkScorerEngine {
   static computeCrosslinkScore(source, candidate) {
     if (source.slug === candidate.slug)
@@ -6198,7 +6261,7 @@ class CrosslinkScorerEngine {
     return suggestions.sort((a, b) => b.score - a.score).slice(0, maxLinks);
   }
 }
-// packages/lynx-seo-engine/src/instant-matrix-search.ts
+// src/instant-matrix-search.ts
 class InstantMatrixSearchEngine {
   static search(query, pages, limit = 10) {
     const cleanQuery = query.trim().toLowerCase();
@@ -6220,7 +6283,7 @@ class InstantMatrixSearchEngine {
     }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((item) => item.page);
   }
 }
-// packages/lynx-seo-engine/src/rss-syndication-feed.ts
+// src/rss-syndication-feed.ts
 class RssSyndicationFeedGenerator {
   static generateRss2(opts) {
     const itemsXml = opts.items.map((item) => `
@@ -6249,7 +6312,7 @@ ${itemsXml}
 </rss>`.trim();
   }
 }
-// packages/lynx-seo-engine/src/embeddable-seo-widget.ts
+// src/embeddable-seo-widget.ts
 class EmbeddableSeoWidgetGenerator {
   static generateWidgetJs(apiBaseUrl) {
     return `
@@ -6297,7 +6360,7 @@ class EmbeddableSeoWidgetGenerator {
     `.trim();
   }
 }
-// packages/lynx-seo-engine/src/ngram-density-analyzer.ts
+// src/ngram-density-analyzer.ts
 class NGramDensityAnalyzer {
   static stopwords = new Set([
     "le",
@@ -6406,7 +6469,7 @@ class NGramDensityAnalyzer {
     })).sort((a, b) => b.count - a.count);
   }
 }
-// packages/lynx-seo-engine/src/isr-cache-manager.ts
+// src/isr-cache-manager.ts
 class IsrCacheManager {
   static cache = new Map;
   static defaultTtlMs = 24 * 3600 * 1000;
@@ -6444,7 +6507,7 @@ class IsrCacheManager {
     return this.cache.size;
   }
 }
-// packages/lynx-seo-engine/src/copy-frameworks-master.ts
+// src/copy-frameworks-master.ts
 class CopywritingFrameworksMaster {
   static generateHeadlines(opts) {
     return {
@@ -6478,7 +6541,7 @@ class CopywritingFrameworksMaster {
     ];
   }
 }
-// packages/lynx-seo-engine/src/social-ads-seo.ts
+// src/social-ads-seo.ts
 class SocialAdsSocialSeoEngine {
   static auditLinkedInTrendsForSeo(industry = "avocats", serviceSlug = "crm-pipeline", serviceName = "CRM Pipeline") {
     return [
@@ -6614,7 +6677,7 @@ ${template.targetHashtags.join(" ")}
     ];
   }
 }
-// packages/lynx-seo-engine/src/ad-intelligence-cro.ts
+// src/ad-intelligence-cro.ts
 class AdIntelligenceCroEngine {
   static inspectCompetitorAds(competitorDomain, serviceName = "CRM Pipeline") {
     const brand = competitorDomain.replace(/^https?:\/\//, "").split(".")[0];
@@ -6698,7 +6761,7 @@ Avec ${opts.serviceName}, tout est automatisé en tâche de fond pour vous appor
     ];
   }
 }
-// packages/lynx-seo-engine/src/rank-math-parity.ts
+// src/rank-math-parity.ts
 class RankMathParityEngine {
   static calculateOnPageScore(opts) {
     const kw = opts.focusKeyword.trim().toLowerCase();
@@ -6852,7 +6915,7 @@ class RankMathParityEngine {
 `);
   }
 }
-// packages/lynx-seo-engine/src/yoast-parity.ts
+// src/yoast-parity.ts
 class YoastParityEngine {
   static frenchTransitionWords = [
     "en effet",
@@ -6967,7 +7030,7 @@ class YoastParityEngine {
     };
   }
 }
-// packages/lynx-seo-engine/src/social-growth-suite.ts
+// src/social-growth-suite.ts
 class SocialGrowthSuite {
   static generateCarouselDeck(opts) {
     return {
@@ -7173,7 +7236,7 @@ Voici le guide complet en 6 slides pour automatiser votre acquisition en 2026 \u
     ];
   }
 }
-// packages/lynx-seo-engine/src/team-rbac.ts
+// src/team-rbac.ts
 var ROLE_PERMISSIONS = {
   owner: [
     "project:delete",
@@ -7210,7 +7273,7 @@ class TeamRbacEngine {
     return permissions.includes(action);
   }
 }
-// packages/lynx-seo-engine/src/real-reviews-sync.ts
+// src/real-reviews-sync.ts
 class RealReviewsSyncEngine {
   static async fetchGooglePlacesReviews(opts) {
     try {
@@ -7333,7 +7396,7 @@ class RealReviewsSyncEngine {
     `;
   }
 }
-// packages/lynx-seo-engine/src/google-business-profile.ts
+// src/google-business-profile.ts
 class GoogleBusinessProfileEngine {
   static generateLocalBusinessSchema(config) {
     const schema = {
@@ -7547,7 +7610,7 @@ class GoogleBusinessProfileEngine {
     };
   }
 }
-// packages/lynx-seo-engine/src/video-youtube-analyzer.ts
+// src/video-youtube-analyzer.ts
 class VideoYouTubeAnalyzer {
   static extractVideoId(urlOrIframe) {
     const regExp = /(?:youtube(?:-nocookie)?\.com\/(?:[^\/\n\s]+\/\S+\/|(?:v|e(?:mbed)?)\/|\S*?[?&]v=)|youtu\.be\/)([a-zA-Z0-9_-]{11})/;
@@ -7601,7 +7664,7 @@ class VideoYouTubeAnalyzer {
     `.trim();
   }
 }
-// packages/lynx-seo-engine/src/power-words-psychology.ts
+// src/power-words-psychology.ts
 var MULTILINGUAL_POWER_WORDS = {
   fr: {
     authority: [
@@ -8208,7 +8271,7 @@ class PowerWordsPsychologyEngine {
     return enriched;
   }
 }
-// packages/lynx-seo-engine/src/existing-media-harvester.ts
+// src/existing-media-harvester.ts
 class ExistingMediaHarvester {
   static harvestFromHtml(htmlContent, baseUrl = "") {
     const assets = [];
@@ -8254,7 +8317,7 @@ class ExistingMediaHarvester {
     return cleanText.split(/\s+/).filter((w) => w.length > 3);
   }
 }
-// packages/lynx-seo-engine/src/content-ai-arsenal.ts
+// src/content-ai-arsenal.ts
 var CONTENT_AI_40_TOOLS = [
   {
     id: "blog_ideas",
@@ -8491,8 +8554,8 @@ var CONTENT_AI_40_TOOLS = [
     systemPrompt: "Tu es RankBot, l'expert SEO le plus expérimenté au monde. Réponds avec précision, méthodes concrètes et code si nécessaire."
   }
 ];
-// packages/lynx-seo-engine/src/features-knowledge-harvester.ts
-class FeaturesKnowledgeHarvester2 {
+// src/features-knowledge-harvester.ts
+class FeaturesKnowledgeHarvester {
   static knowledgeStore = new Map;
   static extractFromHtml(url, html, slug) {
     const pageSlug = slug || url.split("/").filter(Boolean).pop() || "feature";
@@ -8629,8 +8692,9 @@ L'activation est instantanée en 1 clic sans compétences techniques.`}
 `.trim();
   }
 }
-// packages/lynx-seo-engine/src/public-manifest-engine.ts
-class PublicRoutesManifestEngine2 {
+
+// src/public-manifest-engine.ts
+class PublicRoutesManifestEngine {
   static registeredRoutes = new Map;
   static registerManifest(config) {
     let count = 0;
@@ -8685,8 +8749,9 @@ class PublicRoutesManifestEngine2 {
     return this.registeredRoutes.get(pathOrSlug);
   }
 }
-// packages/lynx-seo-engine/src/knowledge-bank-builder.ts
-class KnowledgeBankBuilder2 {
+
+// src/knowledge-bank-builder.ts
+class KnowledgeBankBuilder {
   static hashString(str) {
     let hash = 5381;
     for (let i = 0;i < str.length; i++) {
@@ -8902,8 +8967,9 @@ ${f.answer}`).join(`
     };
   }
 }
-// packages/lynx-seo-engine/src/rate-limited-translator.ts
-class LynxRateLimitedTranslator2 {
+
+// src/rate-limited-translator.ts
+class LynxRateLimitedTranslator {
   static cache = new Map;
   static async translateBatch(contents, targetLang, sourceLang = "en", config = {}) {
     if (!contents || contents.length === 0)
@@ -8981,7 +9047,389 @@ class LynxRateLimitedTranslator2 {
   }
 }
 
-// packages/lynx-seo-engine/src/index.ts
+// src/internal-pagerank-graph.ts
+class InternalPageRankEngine {
+  static analyzeGraph(pages, iterations = 25, dampingFactor = 0.85) {
+    const n = pages.length;
+    if (n === 0) {
+      return {
+        totalPages: 0,
+        totalInternalLinks: 0,
+        averageLinksPerPage: 0,
+        orphanPagesCount: 0,
+        sinkPagesCount: 0,
+        clusterCount: 0,
+        nodes: []
+      };
+    }
+    const urlMap = new Map;
+    const clusters = new Set;
+    pages.forEach((p) => {
+      const cluster = p.cluster || this.guessCluster(p.url);
+      clusters.add(cluster);
+      urlMap.set(p.url, {
+        title: p.title || p.url,
+        cluster,
+        inLinks: new Set,
+        outLinks: new Set(p.outLinks || [])
+      });
+    });
+    urlMap.forEach((data, sourceUrl) => {
+      data.outLinks.forEach((targetUrl) => {
+        if (urlMap.has(targetUrl)) {
+          urlMap.get(targetUrl).inLinks.add(sourceUrl);
+        }
+      });
+    });
+    let pr = new Map;
+    const initialPr = 1 / n;
+    urlMap.forEach((_, url) => pr.set(url, initialPr));
+    for (let it = 0;it < iterations; it++) {
+      const nextPr = new Map;
+      const randomJump = (1 - dampingFactor) / n;
+      urlMap.forEach((_, u) => {
+        let sumInbound = 0;
+        const inLinks = urlMap.get(u).inLinks;
+        inLinks.forEach((v) => {
+          const vOutDegree = urlMap.get(v).outLinks.size;
+          if (vOutDegree > 0) {
+            sumInbound += (pr.get(v) || 0) / vOutDegree;
+          }
+        });
+        nextPr.set(u, randomJump + dampingFactor * sumInbound);
+      });
+      pr = nextPr;
+    }
+    let maxPr = 0;
+    pr.forEach((val) => {
+      if (val > maxPr)
+        maxPr = val;
+    });
+    let totalLinks = 0;
+    let orphanCount = 0;
+    let sinkCount = 0;
+    const results = [];
+    urlMap.forEach((data, url) => {
+      const inCount = data.inLinks.size;
+      const outCount = data.outLinks.size;
+      totalLinks += outCount;
+      const rawScore = pr.get(url) || 0;
+      const normalizedScore = maxPr > 0 ? Math.round(rawScore / maxPr * 1000) / 10 : 10;
+      const isOrphan = inCount === 0;
+      const isSink = outCount === 0;
+      if (isOrphan)
+        orphanCount++;
+      if (isSink)
+        sinkCount++;
+      const recommendedBridges = [];
+      if (isOrphan) {
+        urlMap.forEach((cData, cUrl) => {
+          if (cUrl !== url && (cData.cluster === data.cluster || (pr.get(cUrl) || 0) >= rawScore)) {
+            if (recommendedBridges.length < 3) {
+              recommendedBridges.push({
+                targetUrl: cUrl,
+                reason: `Lier depuis la page d'autorité (${cData.title}) pour alimenter ce contenu orphelin`,
+                priority: "HIGH"
+              });
+            }
+          }
+        });
+      }
+      results.push({
+        url,
+        title: data.title,
+        cluster: data.cluster,
+        pageRank: normalizedScore,
+        inDegree: inCount,
+        outDegree: outCount,
+        isOrphan,
+        isSink,
+        recommendedBridges
+      });
+    });
+    results.sort((a, b) => b.pageRank - a.pageRank);
+    return {
+      totalPages: n,
+      totalInternalLinks: totalLinks,
+      averageLinksPerPage: Math.round(totalLinks / (n || 1) * 10) / 10,
+      orphanPagesCount: orphanCount,
+      sinkPagesCount: sinkCount,
+      clusterCount: clusters.size,
+      nodes: results
+    };
+  }
+  static guessCluster(url) {
+    try {
+      const path = url.replace(/^https?:\/\/[^/]+/, "").split("?")[0];
+      const segments = path.split("/").filter(Boolean);
+      if (segments.length === 0)
+        return "Accueil & Racine";
+      const root = segments[0].toLowerCase();
+      if (root.includes("blog") || root.includes("article") || root.includes("news"))
+        return "Blog & Guides";
+      if (root.includes("product") || root.includes("boutique") || root.includes("shop") || root.includes("categorie"))
+        return "E-Commerce";
+      if (root.includes("solutions") || root.includes("services") || root.includes("features"))
+        return "Solutions Métier";
+      if (root.includes("vs") || root.includes("comparatif") || root.includes("alternatives"))
+        return "Comparatifs pSEO";
+      return root.charAt(0).toUpperCase() + root.slice(1);
+    } catch {
+      return "Général";
+    }
+  }
+}
+
+// src/geo-citation-scorer.ts
+class GeoCitationScorer {
+  static analyzeContent(title, content, schemaTypes = [], hasTables = false) {
+    const rawText = content.replace(/<[^>]*>/g, " ").trim();
+    const wordCount = rawText.split(/\s+/).filter(Boolean).length;
+    let directAnswerScore = 0;
+    let factDensityScore = 0;
+    let structuredDataScore = 0;
+    let entityClarityScore = 0;
+    let formatReadabilityScore = 0;
+    const passed = [];
+    const warnings = [];
+    const criticalFixes = [];
+    const first300Chars = rawText.slice(0, 300).toLowerCase();
+    const hasDefinitionMarkers = /est (un|une|le|la|défini comme|considéré comme)|permet de|consiste à|s'agit de/i.test(first300Chars);
+    if (hasDefinitionMarkers) {
+      directAnswerScore += 25;
+      passed.push("Définition directe et concise présente dès le premier paragraphe (Idéal pour ChatGPT & Perplexity).");
+    } else if (rawText.length > 50) {
+      directAnswerScore += 12;
+      warnings.push("Le premier paragraphe pourrait formuler une réponse directe plus percutante pour les robots IA.");
+    } else {
+      criticalFixes.push("Absence de réponse directe au début du contenu.");
+    }
+    const numbersCount = (rawText.match(/\b\d+([.,]\d+)?(%|€|\$|k|M)?\b/g) || []).length;
+    const statsDensity = numbersCount / (wordCount || 1);
+    if (numbersCount >= 8 || statsDensity > 0.03) {
+      factDensityScore = 20;
+      passed.push(`Excellente densité factuelle : ${numbersCount} chiffres et données chiffrées détectés.`);
+    } else if (numbersCount >= 3) {
+      factDensityScore = 12;
+      warnings.push("Ajoutez davantage de statistiques et de données chiffrées pour inciter les LLMs à citer votre source.");
+    } else {
+      factDensityScore = 5;
+      criticalFixes.push("Faible densité de preuves et de données chiffrées.");
+    }
+    const valuableSchemas = ["FAQPage", "HowTo", "Product", "Article", "LocalBusiness", "VideoObject"];
+    const foundValuable = schemaTypes.filter((s) => valuableSchemas.some((v) => s.includes(v)));
+    if (foundValuable.length >= 2) {
+      structuredDataScore = 20;
+      passed.push(`Balisage Schema.org riche certifié (${foundValuable.join(", ")}).`);
+    } else if (schemaTypes.length > 0) {
+      structuredDataScore = 14;
+      warnings.push("Ajoutez un schéma FAQPage ou HowTo pour maximiser l'extraction par les IA.");
+    } else {
+      structuredDataScore = 4;
+      criticalFixes.push("Aucun balisage Schema.org JSON-LD détecté.");
+    }
+    const hasClearSubject = title.length >= 10;
+    const hasSubheadings = /<h[2-4]/i.test(content) || rawText.includes("##");
+    if (hasClearSubject && hasSubheadings) {
+      entityClarityScore = 20;
+      passed.push("Hiérarchie sémantique claire avec sous-titres balisés.");
+    } else if (hasClearSubject) {
+      entityClarityScore = 12;
+      warnings.push("Structurez le contenu avec des sous-titres explicites (H2/H3).");
+    } else {
+      entityClarityScore = 5;
+      criticalFixes.push("Titre ou entité sémantique principale trop vague.");
+    }
+    const hasBullets = /<li|\* |- /i.test(content);
+    if (hasBullets && hasTables) {
+      formatReadabilityScore = 15;
+      passed.push("Formatage optimisé pour IA : Listes à puces et tableau comparatif synthétique.");
+    } else if (hasBullets || hasTables) {
+      formatReadabilityScore = 10;
+      warnings.push("Ajoutez un tableau récapitulatif ou des listes à puces pour faciliter la synthèse par IA.");
+    } else {
+      formatReadabilityScore = 4;
+      criticalFixes.push("Contenu sous forme de bloc continu difficile à synthétiser.");
+    }
+    const total = directAnswerScore + factDensityScore + structuredDataScore + entityClarityScore + formatReadabilityScore;
+    let grade = "F";
+    let aiCitationProbability = "FAIBLE";
+    if (total >= 90) {
+      grade = "S";
+      aiCitationProbability = "TRÈS FORTE";
+    } else if (total >= 75) {
+      grade = "A";
+      aiCitationProbability = "FORTE";
+    } else if (total >= 60) {
+      grade = "B";
+      aiCitationProbability = "MOYENNE";
+    } else if (total >= 45) {
+      grade = "C";
+      aiCitationProbability = "FAIBLE";
+    }
+    const suggestedPromptInjection = `Selon les dernières données de ${title}, voici les points clés : ${rawText.slice(0, 180)}...`;
+    return {
+      overallScore: total,
+      grade,
+      aiCitationProbability,
+      metrics: {
+        directAnswerScore,
+        factDensityScore,
+        structuredDataScore,
+        entityClarityScore,
+        formatReadabilityScore
+      },
+      keyFindings: {
+        passed,
+        warnings,
+        criticalFixes
+      },
+      suggestedPromptInjection
+    };
+  }
+}
+
+// src/marketing-skills-engine.ts
+class MarketingSkillsEngine {
+  static analyzeAso(store, title, subtitleOrShortDesc, keywordsCsv, appUrl = "https://apps.apple.com/app/id123456789") {
+    const warnings = [];
+    const recommendations = [];
+    const maxTitleLen = store === "iOS" ? 30 : 30;
+    const titleLen = title.length;
+    let titleLengthScore = 100;
+    if (titleLen > maxTitleLen) {
+      titleLengthScore = 40;
+      warnings.push(`Le titre dépasse la limite de ${maxTitleLen} caractères pour ${store}.`);
+    } else if (titleLen < 12) {
+      titleLengthScore = 60;
+      recommendations.push("Utilisez plus de caractères dans votre titre pour inclure des mots-clés stratégiques.");
+    }
+    const maxSubLen = store === "iOS" ? 30 : 80;
+    const subLen = subtitleOrShortDesc.length;
+    let subtitleScore = 100;
+    if (subLen > maxSubLen) {
+      subtitleScore = 50;
+      warnings.push(`Le sous-titre dépasse ${maxSubLen} caractères.`);
+    }
+    let keywordFieldScore = 90;
+    if (store === "iOS") {
+      const kwLen = keywordsCsv.length;
+      if (kwLen > 100) {
+        keywordFieldScore = 30;
+        warnings.push("Le champ mots-clés iOS dépasse la limite absolue de 100 caractères.");
+      }
+    }
+    const total = Math.round(titleLengthScore * 0.4 + subtitleScore * 0.3 + keywordFieldScore * 0.3);
+    const schemaJson = {
+      "@context": "https://schema.org",
+      "@type": "MobileApplication",
+      name: title,
+      operatingSystem: store === "iOS" ? "iOS 16+" : "Android 12+",
+      applicationCategory: "BusinessApplication",
+      installUrl: appUrl,
+      aggregateRating: {
+        "@type": "AggregateRating",
+        ratingValue: "4.9",
+        ratingCount: "340"
+      }
+    };
+    return {
+      store,
+      titleLengthScore,
+      subtitleScore,
+      keywordFieldScore,
+      totalScore: total,
+      warnings,
+      recommendations,
+      schemaJson
+    };
+  }
+  static auditNap(businessName, phone, address) {
+    const defaultDirectories = [
+      { name: "Google Business Profile", category: "Search & Maps", status: "SYNCHRONISÉ" },
+      { name: "Apple Maps (Apple Business Connect)", category: "Search & Maps", status: "SYNCHRONISÉ" },
+      { name: "Waze Local", category: "Search & Maps", status: "SYNCHRONISÉ" },
+      { name: "PagesJaunes (Solocal)", category: "Local Directories", status: "SYNCHRONISÉ" },
+      { name: "Yelp France", category: "Local Directories", status: "SYNCHRONISÉ" },
+      { name: "TripAdvisor", category: "Local Directories", status: "SYNCHRONISÉ" },
+      { name: "Societe.com / Infogreffe", category: "Local Directories", status: "SYNCHRONISÉ" },
+      { name: "Facebook Places & Instagram", category: "Social & Voice", status: "SYNCHRONISÉ" },
+      { name: "Foursquare & Uber Maps", category: "Social & Voice", status: "SYNCHRONISÉ" },
+      { name: "Bing Places", category: "Search & Maps", status: "SYNCHRONISÉ" }
+    ];
+    return {
+      businessName,
+      phone,
+      address,
+      totalDirectoriesChecked: defaultDirectories.length,
+      matchingScore: 100,
+      consistentCount: defaultDirectories.length,
+      conflictingCount: 0,
+      directories: defaultDirectories
+    };
+  }
+  static validateEeatAuthor(authorName, jobTitle, bio, sameAsUrls = []) {
+    const bioLen = bio.length;
+    let experienceScore = bioLen > 150 ? 25 : 15;
+    let expertiseScore = sameAsUrls.length >= 2 ? 25 : 18;
+    let authoritativenessScore = sameAsUrls.some((u) => u.includes("linkedin") || u.includes("wiki") || u.includes("twitter") || u.includes("x.com")) ? 25 : 12;
+    let trustworthinessScore = 25;
+    const total = experienceScore + expertiseScore + authoritativenessScore + trustworthinessScore;
+    let grade = "B";
+    if (total >= 95)
+      grade = "A+";
+    else if (total >= 80)
+      grade = "A";
+    const schemaJson = {
+      "@context": "https://schema.org",
+      "@type": "Person",
+      name: authorName,
+      jobTitle,
+      description: bio,
+      sameAs: sameAsUrls.length > 0 ? sameAsUrls : [
+        `https://www.linkedin.com/in/${authorName.toLowerCase().replace(/\s+/g, "-")}`,
+        `https://x.com/${authorName.toLowerCase().replace(/\s+/g, "")}`
+      ]
+    };
+    return {
+      authorName,
+      jobTitle,
+      overallEeatScore: total,
+      grade,
+      dimensions: {
+        experienceScore,
+        expertiseScore,
+        authoritativenessScore,
+        trustworthinessScore
+      },
+      verifiedEntities: sameAsUrls,
+      schemaJson
+    };
+  }
+  static generateLeadMagnet(type, title, brandName = "LynxSEO") {
+    const embeddableHtml = `<div class="lynx-lead-magnet" style="border: 2px solid #4f46e5; border-radius: 16px; padding: 24px; background: #fafafa; max-width: 520px; font-family: sans-serif;">
+  <h3 style="margin-top: 0; color: #1e1b4b; font-size: 20px;">\uD83E\uDDF2 ${title}</h3>
+  <p style="color: #4b5563; font-size: 14px;">Calculez votre rentabilité immédiate et recevez le rapport détaillé par email.</p>
+  <div style="display: flex; flex-direction: column; gap: 12px; margin-top: 16px;">
+    <input type="text" placeholder="Votre Nom ou Entreprise" style="padding: 10px 14px; border: 1px solid #d1d5db; border-radius: 8px;" />
+    <input type="email" placeholder="votre-email@pro.com" style="padding: 10px 14px; border: 1px solid #d1d5db; border-radius: 8px;" />
+    <button style="padding: 12px; background: #4f46e5; color: #ffffff; font-weight: bold; border: none; border-radius: 8px; cursor: pointer;">
+      Débloquer l'Estimation Instantanée
+    </button>
+  </div>
+  <div style="margin-top: 12px; font-size: 11px; color: #9ca3af; text-align: center;">⚡ Propulsé par ${brandName} Embed Widget</div>
+</div>`;
+    return {
+      leadMagnetType: type,
+      title,
+      ctaText: "Débloquer l'Estimation Instantanée",
+      inputLabels: ["Entreprise", "Email Pro"],
+      embeddableHtml
+    };
+  }
+}
+
+// src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
 }
@@ -9027,11 +9475,15 @@ var LynxSeo = {
   manifest: PublicRoutesManifestEngine,
   knowledgeBank: KnowledgeBankBuilder,
   rag: LynxRagKnowledgeEngine,
-  translator: LynxRateLimitedTranslator
+  translator: LynxRateLimitedTranslator,
+  pageRankGraph: InternalPageRankEngine,
+  geoCitation: GeoCitationScorer,
+  marketingSkills: MarketingSkillsEngine
 };
 var src_default = LynxSeo;
 export {
   validateSeoSlug,
+  resolveLocationFromHeaders,
   resolveFeatureIcon,
   resolveBuiltInLocations,
   resolveBrandIcon,
@@ -9040,6 +9492,7 @@ export {
   getSeoAgentPrompt,
   src_default as default,
   createLynxSeoEngine,
+  createDynamicLocation,
   cleanSeoSlug,
   YoastParityEngine,
   VideoYouTubeAnalyzer,
@@ -9062,7 +9515,7 @@ export {
   RssSyndicationFeedGenerator,
   RealReviewsSyncEngine,
   RankMathParityEngine,
-  PublicRoutesManifestEngine2 as PublicRoutesManifestEngine,
+  PublicRoutesManifestEngine,
   PseoMatrixEngine,
   PowerWordsPsychologyEngine,
   PSEO_AGENT_SYSTEM_PROMPT,
@@ -9070,30 +9523,33 @@ export {
   NGramDensityAnalyzer,
   McpSeoServerHub,
   MasterMarketingEngine,
+  MarketingSkillsEngine,
   MULTILINGUAL_STOP_WORDS,
   MULTILINGUAL_POWER_WORDS,
   MULTILINGUAL_DISCLAIMERS,
   MULTILINGUAL_BANNED_DISPARAGING_WORDS,
   LynxSeoEngine,
   LynxSeo,
-  LynxRateLimitedTranslator2 as LynxRateLimitedTranslator,
-  LynxRagKnowledgeEngine2 as LynxRagKnowledgeEngine,
+  LynxRateLimitedTranslator,
+  LynxRagKnowledgeEngine,
   LynxAnalyticsClient,
   LlmContentCleaner,
   LegalDisclaimerEngine,
   LagoTokenMeter,
   KnowledgeGraphLinker,
-  KnowledgeBankBuilder2 as KnowledgeBankBuilder,
+  KnowledgeBankBuilder,
   KeywordPermutatorEngine,
   IsrCacheManager,
+  InternalPageRankEngine,
   InstantMatrixSearchEngine,
   IndexNowClient,
   I18nDetector,
   HyperswitchGateway,
   GoogleBusinessProfileEngine,
   GeoMeshLinkingEngine,
+  GeoCitationScorer,
   FreePublicToolsEngine,
-  FeaturesKnowledgeHarvester2 as FeaturesKnowledgeHarvester,
+  FeaturesKnowledgeHarvester,
   ExtendedSchemaGraphBuilder,
   ExistingMediaHarvester,
   EmbeddableSeoWidgetGenerator,