@lynxflow/seo-engine 1.5.8 → 1.5.9

package/README.md

@@ -57,47 +57,101 @@ The SDK structures programmatic content across **10 canonical root pillars** exp
 
 ## Quickstart
 
-### 1. Initialize Engine
+### 1. Initialize Engine & Configure Minimal Inputs
+
+The SDK runs **in-memory inside the client application** (< 0.05ms) and automatically provisions verified cities, populations, GPS coordinates, and currencies from its built-in global demographic database.
 
 ```typescript
 import { PseoMatrixEngine } from "@lynxflow/seo-engine";
 
-export const matrixEngine = new PseoMatrixEngine({
-  companyName: "Acme Cloud",
-  language: "en", // "en" default, supports "fr", "de", "es", "it", "pt", etc.
-  correctionsEmail: "compliance@acme.com",
-});
-```
+export const matrixEngine = new PseoMatrixEngine();
 
-### 2. Resolve Programmatic Pages
+export const SEO_CONFIG = {
+  brandName: "Acme Cloud",
+  languages: ["fr", "en", "es"], // Supported site languages
+  countries: ["france", "espagne", "belgique"], // Or "europe" / "international" — SDK auto-provisions verified cities!
+  cleanDirectRoutes: true, // Eliminates parasite words (/solutions/, etc.) for direct /{service}/{city}
+};
 
-```typescript
-const pages = matrixEngine.generateAllMatrices("https://example.com", {
+export const PSEO_DATASET = {
   services: [
-    { slug: "crm-pipeline", name: "Sales CRM", category: "Sales", keyFeatures: ["Kanban"], description: "CRM" }
+    { 
+      slug: "autopost-facebook", 
+      name: "Autopost Facebook & Instagram", 
+      category: "Social Media", 
+      keyFeatures: ["AI Scheduling", "Visual Calendar", "Auto-Hashtags"],
+      description: "Automated social media posting engine" 
+    },
+    { 
+      slug: "crm-pipeline", 
+      name: "Visual CRM Pipeline", 
+      category: "Sales", 
+      keyFeatures: ["Kanban", "Lead scoring"],
+      description: "Visual deal tracking software" 
+    },
   ],
   targets: [
-    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Security"] }
+    { slug: "agences", name: "Marketing Agencies", type: "industry", painPoints: ["Manual Posting"], benefits: ["10x Output"] }
   ],
   integrations: [
-    { slug: "slack", name: "Slack", category: "Communication", syncFeatures: ["Alerts"] }
+    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Catalog sync"] }
   ],
   templates: [
-    { slug: "pipeline-excel", title: "Sales Pipeline", topic: "Sales", format: "excel", benefits: ["Free"] }
+    { slug: "social-calendar-excel", title: "Social Media Calendar", topic: "Social Media", format: "excel", benefits: ["Free download"] }
   ],
   glossaryTerms: [
-    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" }
+    { slug: "engagement-rate", term: "Engagement Rate", shortDefinition: "Percentage of audience interacting with content" }
   ]
-}, { brandName: "Acme" });
+};
+```
 
-console.log(pages[0].urlPath);      // "/for/law-firms"
-console.log(pages[0].schemaGraph);  // Injected Schema.org JSON-LD graph
+### 2. Next.js Universal Dynamic Catch-All (`app/[...slug]/page.tsx`)
+
+```tsx
+import { notFound } from "next/navigation";
+import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+
+export async function generateMetadata({ params }: { params: { slug: string[] } }) {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
+  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 domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  // ⚡ Resolved mathematically in local RAM in < 0.05ms
+  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
+  if (!page) notFound();
+
+  return (
+    <article className="min-h-screen bg-background text-foreground py-12 px-6 max-w-5xl mx-auto space-y-8">
+      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
+      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
+      <p className="text-lg text-muted-foreground">{page.description}</p>
+      {page.neighboringLinks && (
+        <nav className="flex flex-wrap gap-2 pt-6">
+          {page.neighboringLinks.map((l) => (
+            <a key={l.url} href={l.url} className="px-3 py-1 bg-secondary rounded text-xs">{l.name}</a>
+          ))}
+        </nav>
+      )}
+    </article>
+  );
+}
 ```
 
-### 3. URL Slug Cleansing (6 Golden Rules)
+### 3. XML Sitemap & `/llms.txt` Feeds (1 Line of Code)
 
 ```typescript
-import { cleanSeoSlug, validateSeoSlug } from "@lynxflow/seo-engine";
+// app/sitemap.ts
+export default function sitemap() {
+  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
+  return matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG)
+    .filter(p => p.robots.includes("index"))
+    .map(p => ({ url: p.canonicalUrl, lastModified: new Date() }));
+}
+```
 
 const slug = cleanSeoSlug("The best software for managing client invoices in 2026", { language: "en" });
 console.log(slug); // "best-software-managing-client-invoices"

package/dist/matrix-engine.d.ts

@@ -127,6 +127,7 @@ export interface GeneratedPageMeta {
 export interface MatrixOptions {
     brandName: string;
     language?: string;
+    languages?: string[];
     countries?: string[] | string;
     territories?: string[] | string;
     cleanDirectRoutes?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.5.8",
+  "version": "1.5.9",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/matrix-engine.ts

@@ -156,6 +156,7 @@ export interface GeneratedPageMeta {
 export interface MatrixOptions {
   brandName: string;
   language?: string; // Default: "en", supports "fr", "de", "es", "pt", "it", etc.
+  languages?: string[]; // Array of supported site languages (e.g. ["fr", "en", "es"])
   countries?: string[] | string; // e.g. ["france", "spain"] or "europe" or "international"
   territories?: string[] | string; // Alias for countries
   cleanDirectRoutes?: boolean; // When true (default), eliminates parasite words (/solutions/, etc.) for direct /{service}/{city}