@lynxflow/seo-engine 1.8.29 → 2.0.0

package/TUTORIEL_INTEGRATION_SITE.md

@@ -1,283 +0,0 @@
-# 📘 Master Integration Tutorial — Programmatic SEO SDK
-
-> **Designed for software engineers and autonomous AI coding agents (Claude, Cursor, Copilot, ChatGPT, Antigravity).**  
-> Explains how to integrate `@lynxflow/seo-engine` into **ANY WEB APPLICATION** to generate programmatic landing pages, sitemaps, `robots.txt`, and `/llms.txt`.
-
----
-
-## 🎯 4 Files to Deploy 100% of Your Programmatic SEO
-
-```text
-your-project/
-├── lib/
-│   └── seo.ts                  ➔ 1. Declare your product modules, targets, and integrations
-└── app/
-    ├── [...slug]/
-    │   └── page.tsx            ➔ 2. Unified route rendering all 10 matrix families (< 0.05ms)
-    ├── sitemap.ts              ➔ 3. Partitioned XML Sitemap generator (45k chunks)
-    ├── robots.ts               ➔ 4. robots.txt with optimal AI bot allowances (GPTBot, ClaudeBot)
-    └── llms.txt/
-        └── route.ts            ➔ 5. Clean Markdown feed for ChatGPT Search & Perplexity
-```
-
----
-
-## 🛠️ Step 1: Declare Product Services & Matrices (`lib/seo.ts`)
-
-Create `lib/seo.ts` to define your product configuration:
-
-```typescript
-// lib/seo.ts
-import { PseoMatrixEngine } from "@lynxflow/seo-engine";
-
-export const matrixEngine = new PseoMatrixEngine({
-  companyName: "Acme Cloud",
-  correctionsEmail: "compliance@acme.com",
-  language: "en", // "en" default, supports "fr", "de", "es", etc.
-});
-
-export const SEO_CONFIG = {
-  brandName: "Acme",
-  language: "en",
-  minPopulationToIndex: 15_000,
-  organizationSameAs: [
-    "https://twitter.com/acme",
-    "https://linkedin.com/company/acme",
-    "https://wikidata.org/wiki/Q12345",
-  ],
-};
-
-export const PSEO_DATASET = {
-  // 1. Product features / Services
-  services: [
-    {
-      slug: "crm-pipeline",
-      name: "Omnichannel CRM & Pipeline",
-      category: "Sales",
-      description: "Visual pipeline and automated lead scoring.",
-      keyFeatures: ["Visual Kanban", "Lead scoring", "Automated follow-ups"],
-      priceMonthly: 49,
-    },
-  ],
-
-  // 2. Verified Competitor Data (VS, Alternatives, Pricing)
-  competitors: [
-    {
-      slug: "hubspot",
-      name: "HubSpot",
-      category: "CRM",
-      drawbacks: ["High onboarding fee", "Contact tier limits"],
-      advantagesOver: ["No seat lock-in", "Native automated workflows"],
-      startingPrice: 50,
-      lastVerifiedDate: "2026-08-01",
-    },
-  ],
-
-  // 3. Unified Industry & Role Targets (Anti-cannibalization)
-  targets: [
-    {
-      slug: "law-firms",
-      name: "Law Firms & Attorneys",
-      type: "industry" as const,
-      painPoints: ["Client confidentiality", "Billing tracking"],
-      benefits: ["End-to-end encryption", "Automated retainer invoices"],
-    },
-    {
-      slug: "sales-directors",
-      name: "Sales Directors & VP of Sales",
-      type: "role" as const,
-      painPoints: ["Pipeline visibility", "Team quota tracking"],
-      benefits: ["Real-time revenue forecast", "Instant rep activity logs"],
-    },
-  ],
-
-  // 4. Integrations & Connectors
-  integrations: [
-    {
-      slug: "shopify",
-      name: "Shopify",
-      category: "E-Commerce",
-      syncFeatures: ["Real-time order sync", "Customer lifetime value"],
-    },
-    {
-      slug: "slack",
-      name: "Slack",
-      category: "Communication",
-      syncFeatures: ["Instant deal alerts", "Pipeline command bot"],
-    },
-  ],
-
-  // 5. Actionable Use Cases
-  useCases: [
-    {
-      slug: "automated-quote-followup",
-      title: "Automate Quote Follow-ups",
-      problem: "45% of sent quotes go cold without systematic follow-ups.",
-      solutionWorkflow: [
-        "Detect unanswered proposal after 48 hours",
-        "Send personalized multi-channel reminder",
-        "Notify account executive upon client view",
-      ],
-      expectedRoi: "+28% close rate",
-    },
-  ],
-
-  // 6. Lead Magnet Templates
-  templates: [
-    {
-      slug: "sales-pipeline-excel",
-      title: "Sales Pipeline Tracker",
-      topic: "Sales Management",
-      format: "excel" as const,
-      benefits: ["Pre-built formula calculations", "Weighted deal probability"],
-    },
-  ],
-
-  // 7. Topic Authority Glossary
-  glossaryTerms: [
-    {
-      slug: "mrr",
-      term: "MRR (Monthly Recurring Revenue)",
-      shortDefinition: "Predictable monthly revenue generated by active subscriptions.",
-    },
-  ],
-};
-```
-
----
-
-## 🛠️ Step 2: Dynamic Catch-All Route (`app/[...slug]/page.tsx`)
-
-```tsx
-// app/[...slug]/page.tsx
-import { notFound } from "next/navigation";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export async function generateMetadata({ params }: { params: { slug: string[] } }) {
-  const path = "/" + params.slug.join("/");
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://acme.com";
-  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
-  const page = pages.find((p) => p.urlPath === path);
-
-  if (!page) return {};
-
-  return {
-    title: page.title,
-    description: page.description,
-    alternates: { canonical: page.canonicalUrl },
-    robots: page.robots,
-  };
-}
-
-export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
-  const path = "/" + params.slug.join("/");
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://acme.com";
-  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
-  const page = pages.find((p) => p.urlPath === path);
-
-  if (!page) notFound();
-
-  return (
-    <article className="max-w-4xl mx-auto py-12 px-6">
-      {/* Schema.org Rich Graph */}
-      <script
-        type="application/ld+json"
-        dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }}
-      />
-
-      <h1 className="text-4xl font-extrabold tracking-tight text-gray-900">{page.h1}</h1>
-      <p className="mt-4 text-xl text-gray-600 leading-relaxed">{page.description}</p>
-
-      {/* Legal & Editorial Disclaimer */}
-      {page.disclaimerText && (
-        <aside className="mt-8 p-4 bg-gray-50 border border-gray-200 rounded-lg text-xs text-gray-500">
-          {page.disclaimerText}
-        </aside>
-      )}
-    </article>
-  );
-}
-```
-
----
-
-## 🛠️ Step 3: Partitioned XML Sitemap (`app/sitemap.ts`)
-
-```typescript
-// app/sitemap.ts
-import { MetadataRoute } from "next";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export default function sitemap(): MetadataRoute.Sitemap {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://acme.com";
-  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
-
-  return pages
-    .filter((p) => p.robots.includes("index"))
-    .map((p) => ({
-      url: p.canonicalUrl,
-      lastModified: new Date(),
-      changeFrequency: "weekly",
-      priority: 0.8,
-    }));
-}
-```
-
----
-
-## 🛠️ Step 4: AI Bots `robots.txt` (`app/robots.ts`)
-
-```typescript
-// app/robots.ts
-import { MetadataRoute } from "next";
-
-export default function robots(): MetadataRoute.Robots {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://acme.com";
-
-  return {
-    rules: [
-      {
-        userAgent: "*",
-        allow: "/",
-      },
-      {
-        userAgent: ["GPTBot", "ChatGPT-User", "ClaudeBot", "PerplexityBot"],
-        allow: "/",
-      },
-    ],
-    sitemap: `${domain}/sitemap.xml`,
-  };
-}
-```
-
----
-
-## 🛠️ Step 5: Clean Markdown for AI Search (`app/llms.txt/route.ts`)
-
-```typescript
-// app/llms.txt/route.ts
-import { NextResponse } from "next/server";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export async function GET() {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://acme.com";
-  const pages = matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG);
-
-  const markdown = [
-    `# ${SEO_CONFIG.brandName} Knowledge Base`,
-    `> Direct structured index for LLMs and AI Agents.`,
-    ``,
-    `## Solutions & Use Cases`,
-    ...pages.map((p) => `- [${p.h1}](${p.canonicalUrl}): ${p.description}`),
-  ].join("\n");
-
-  return new NextResponse(markdown, {
-    headers: { "Content-Type": "text/plain; charset=utf-8" },
-  });
-}
-```
-
----
-
-## 🚀 That's it!
-Your application now deploys thousands of high-converting, compliant programmatic pages in **under 0.05ms** response time.

package/connectors/cloudflare-worker/worker.js

@@ -1,106 +0,0 @@
-/**
- * ⚡ Cloudflare Worker Universal Reverse-Proxy Connector
- * 
- * Works for: Shopify, Webflow, Wix, Squarespace, Framer, Astro, and any static site.
- * Intercepts all 8 Programmatic Matrices with sub-20ms edge caching across 300+ PoPs:
- * 1. 📍 /solutions/* (Local / GEO)
- * 2. 🥊 /comparatif/*, /comparison/*, /vs/* (Comparatifs)
- * 3. 🔄 /alternatives/* (Alternatives)
- * 4. 🏢 /secteurs/*, /industries/* (Secteurs Métiers)
- * 5. 🔌 /integrations/* (Intégrations Tech)
- * 6. 👤 /metiers/*, /roles/* (Personas)
- * 7. 🎯 /cas-usage/*, /use-cases/* (Cas d'Usage)
- * 8. 🧮 /outils/*, /tools/* (Outils ROI)
- */
-
-const LYNXFLOW_LICENSE_KEY = "lynx_growth_votre_cle_ici";
-const LYNXFLOW_ENGINE_URL = "https://lynxintel.io/api/v1/render-page";
-
-const INTERCEPT_PATTERNS = [
-  "/solutions/",
-  "/comparatif/",
-  "/comparison/",
-  "/vs/",
-  "/alternatives/",
-  "/secteurs/",
-  "/industries/",
-  "/integrations/",
-  "/metiers/",
-  "/roles/",
-  "/cas-usage/",
-  "/use-cases/",
-  "/outils/",
-  "/tools/"
-];
-
-export default {
-  async fetch(request, env, ctx) {
-    const url = new URL(request.url);
-    const cleanPath = url.pathname.toLowerCase();
-
-    // Check if path or localized path matches any of the 8 matrices
-    const isProgrammaticRoute = INTERCEPT_PATTERNS.some((pattern) =>
-      cleanPath.includes(pattern)
-    );
-
-    if (isProgrammaticRoute) {
-      const cache = caches.default;
-      let response = await cache.match(request);
-
-      if (!response) {
-        const payload = {
-          licenseKey: LYNXFLOW_LICENSE_KEY,
-          path: url.pathname,
-          domain: url.origin,
-          brandName: "Votre Entreprise"
-        };
-
-        const res = await fetch(LYNXFLOW_ENGINE_URL, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(payload)
-        });
-
-        if (res.ok) {
-          const data = await res.json();
-          const html = `<!DOCTYPE html>
-<html lang="${data.locale || 'fr'}">
-<head>
-  <meta charset="UTF-8">
-  <title>${data.title}</title>
-  <meta name="description" content="${data.description}">
-  <script type="application/ld+json">${JSON.stringify(data.jsonLd)}</script>
-  <style>
-    body { font-family: system-ui, -apple-system, sans-serif; max-width: 900px; margin: 40px auto; padding: 0 20px; line-height: 1.6; color: #1e293b; }
-    h1 { font-size: 2.25rem; font-weight: 800; color: #0f172a; }
-    .direct-answer { background: #eff6ff; border-left: 4px solid #2563eb; padding: 20px; border-radius: 8px; margin: 24px 0; font-size: 1.1rem; }
-  </style>
-</head>
-<body>
-  <h1>${data.h1}</h1>
-  <p>${data.description}</p>
-  <div class="direct-answer"><strong>En Résumé :</strong> ${data.directAnswer}</div>
-  <article>${data.htmlBody}</article>
-</body>
-</html>`;
-
-          response = new Response(html, {
-            status: 200,
-            headers: {
-              "Content-Type": "text/html; charset=utf-8",
-              "Cache-Control": "public, max-age=604800, s-maxage=604800", // 7 jours de cache Edge
-              "X-Lynx-Engine": "Powered-by-LynxFlow",
-            }
-          });
-
-          ctx.waitUntil(cache.put(request, response.clone()));
-        }
-      }
-
-      if (response) return response;
-    }
-
-    // Fallthrough to standard website (Shopify/Webflow/Wix)
-    return fetch(request);
-  }
-};

package/connectors/laravel/LynxSeoController.php

@@ -1,37 +0,0 @@
-<?php
-
-namespace App\Http\Controllers;
-
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Http;
-use Illuminate\Support\Facades\Cache;
-
-class LynxSeoController extends Controller
-{
-    /**
-     * Universal Programmatic Controller: Serves all 8 Programmatic Matrix types
-     * with 24h local Redis/file caching.
-     */
-    public function resolve(Request $request)
-    {
-        $path = $request->path();
-        $cacheKey = "lynx_page_" . md5($path);
-
-        $pageData = Cache::remember($cacheKey, 86400, function () use ($path, $request) {
-            $response = Http::timeout(3)->post(config('services.lynxflow.endpoint', 'https://lynxintel.io/api/v1/render-page'), [
-                'licenseKey' => config('services.lynxflow.license_key'),
-                'path'       => $path,
-                'domain'     => $request->root(),
-                'brandName'  => config('app.name'),
-            ]);
-
-            return $response->successful() ? $response->json() : null;
-        });
-
-        if (!$pageData) {
-            abort(404);
-        }
-
-        return view('lynx-seo.landing', ['page' => $pageData]);
-    }
-}