@lynxflow/seo-engine 1.4.1 → 1.5.0

package/dist/engine.d.ts

@@ -17,7 +17,7 @@
  */
 import type { LynxSeoConfig, LynxResolvedPage } from "./types";
 import { IndexNowClient, type IndexNowResponse } from "./indexnow-client";
-import { LynxAnalyticsClient } from "./analytics-client";
+import { LynxAnalyticsClient, type UrlTrafficStats } from "./analytics-client";
 import { SerpClient } from "./serp-client";
 import { BacklinksClient } from "./backlinks-client";
 import { AiCopilotClient } from "./ai-copilot-client";
@@ -77,8 +77,36 @@ export declare class LynxSeoEngine {
      * Returns the list of all distinct unique URL paths generated so far.
      */
     getUniquePageList(): string[];
+    /**
+     * Alias for getUniquePageList: returns all distinct unique URLs created by the engine.
+     */
+    getAllCreatedLinks(): string[];
+    /**
+     * Returns full traffic statistics (views, visitors, AI bots, conversions) for all created links.
+     */
+    getStatsPerLink(): UrlTrafficStats[];
+    /**
+     * Returns traffic statistics and visit counts for a single specific link.
+     */
+    getLinkStats(path: string): UrlTrafficStats;
     /**
      * Performs an automated deep crawl and technical SEO audit of the configured domain.
      */
     crawlSite(options?: CrawlOptions): Promise<SiteAuditSummary>;
+    /**
+     * 🗺️ Generates all combinatorially possible programmatic SEO URLs based on registered services and matrices.
+     */
+    generateAllPossibleUrls(): string[];
+    /**
+     * 🗺️ Generates a fully compliant XML sitemap string for Googlebot and Bing.
+     */
+    generateSitemapXml(customUrls?: string[]): string;
+    /**
+     * 🤖 Generates a compliant robots.txt with AI search crawler rules and sitemap link.
+     */
+    generateRobotsTxt(customSitemapUrl?: string): string;
+    /**
+     * 📄 Generates the official /llms.txt markdown feed for LLM agents (ChatGPT, Claude, Perplexity).
+     */
+    generateLlmsTxt(): string;
 }

package/dist/engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/extended-schemas.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Extended Universal Schema.org Rich Graph Builder
+ * Supports 50+ Schema.org official types for Google Search Rich Results:
+ * - SoftwareApplication, WebApplication, MobileApplication
+ * - 35+ LocalBusiness Subtypes (Plumber, HVACBusiness, Electrician, Dentist, LegalService, AccountingService, etc.)
+ * - Organization with Entity SEO sameAs links (Wikidata, Crunchbase, LinkedIn)
+ * - Product, Offer, MerchantReturnPolicy
+ * - Article, TechArticle, NewsArticle
+ * - HowTo, HowToStep
+ * - FAQPage
+ * - BreadcrumbList
+ */
+export declare const SCHEMA_LOCAL_BUSINESS_MAP: Record<string, string>;
+export interface SchemaOrgOrganizationOpts {
+    name: string;
+    url: string;
+    logo?: string;
+    sameAs?: string[];
+    contactPoint?: {
+        telephone: string;
+        contactType: string;
+        availableLanguage: string[];
+    };
+}
+export interface SchemaOrgLocalBusinessOpts {
+    name: string;
+    url: string;
+    schemaType?: string;
+    telephone?: string;
+    email?: string;
+    streetAddress?: string;
+    city: string;
+    region?: string;
+    postalCode?: string;
+    country: string;
+    latitude?: number;
+    longitude?: number;
+    openingHours?: string[];
+    priceRange?: string;
+}
+export interface SchemaOrgProductOpts {
+    name: string;
+    description: string;
+    url: string;
+    brandName: string;
+    price: number;
+    currency: string;
+    image?: string;
+}
+export interface SchemaOrgArticleOpts {
+    headline: string;
+    description: string;
+    url: string;
+    datePublished?: string;
+    dateModified?: string;
+    authorName: string;
+    publisherName: string;
+}
+export declare class ExtendedSchemaGraphBuilder {
+    /**
+     * Resolves the most accurate Schema.org type for a business sector or keyword.
+     */
+    static resolveBusinessType(industryOrSectorSlug: string): string;
+    /**
+     * 1. Organization with Entity SEO sameAs links
+     */
+    static buildOrganization(opts: SchemaOrgOrganizationOpts): Record<string, unknown>;
+    /**
+     * 2. LocalBusiness with GeoCoordinates & Address
+     */
+    static buildLocalBusiness(opts: SchemaOrgLocalBusinessOpts): Record<string, unknown>;
+    /**
+     * 3. SoftwareApplication & WebApplication
+     */
+    static buildSoftwareApplication(opts: {
+        name: string;
+        description: string;
+        url: string;
+        priceMonthly?: number;
+        currency?: string;
+        operatingSystem?: string;
+        category?: string;
+    }): Record<string, unknown>;
+    /**
+     * 4. FAQPage
+     */
+    static buildFAQPage(faqs: {
+        question: string;
+        answer: string;
+    }[]): Record<string, unknown>;
+    /**
+     * 5. HowTo & HowToStep
+     */
+    static buildHowTo(opts: {
+        name: string;
+        description: string;
+        steps: string[];
+    }): Record<string, unknown>;
+    /**
+     * 6. BreadcrumbList
+     */
+    static buildBreadcrumbs(items: {
+        name: string;
+        url: string;
+    }[]): Record<string, unknown>;
+}

package/dist/geo-mesh-linking.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 🗺️ Geographic Mesh Linking Engine
+ *
+ * Implements geodesic distance calculation (Haversine formula) and
+ * administrative zone clustering to connect neighboring cities and propagate PageRank.
+ */
+export interface GeoCoordinate {
+    latitude: number;
+    longitude: number;
+}
+export interface MeshCity {
+    slug: string;
+    name: string;
+    departmentCode?: string;
+    region?: string;
+    country: string;
+    coordinates?: GeoCoordinate;
+    population?: number;
+}
+export declare class GeoMeshLinkingEngine {
+    /**
+     * Computes the great-circle distance between two points in kilometers (Haversine formula).
+     */
+    static computeDistanceKm(coord1: GeoCoordinate, coord2: GeoCoordinate): number;
+    private static deg2rad;
+    /**
+     * Finds the N closest neighbor cities within the same country / department / distance.
+     */
+    static findClosestNeighbors(targetCity: MeshCity, allCities: MeshCity[], maxNeighbors?: number, maxDistanceKm?: number): {
+        city: MeshCity;
+        distanceKm?: number;
+    }[];
+}

package/dist/index.d.ts

@@ -10,6 +10,10 @@
  * - 🦩 Lago Metered Token Billing (`ai_tokens`) & Hyperswitch Payment Switch
  */
 export * from "./engine";
+export * from "./slug-engine";
+export * from "./legal-disclaimers";
+export * from "./matrix-engine";
+export * from "./llm-prompt";
 export * from "./auth-key";
 export * from "./token-quota-manager";
 export * from "./lago-token-meter";
@@ -17,11 +21,39 @@ export * from "./indexnow-client";
 export * from "./site-auditor";
 export * from "./site-crawler";
 export * from "./schema-builder";
+export * from "./extended-schemas";
 export * from "./analytics-client";
 export * from "./serp-client";
 export * from "./backlinks-client";
 export * from "./ai-copilot-client";
 export * from "./types";
+export * from "./geo-mesh-linking";
+export * from "./brand-dna-calendar";
+export * from "./technical-rules-auditor";
+export * from "./ai-bots-log-analyzer";
+export * from "./serp-history-alerts";
+export * from "./seo-opportunities-decay";
+export * from "./knowledge-graph-linker";
+export * from "./cro-copywriting-engine";
+export * from "./mcp-seo-server";
+export * from "./master-marketing-engine";
+export * from "./social-video-seo";
+export * from "./social-trend-seo";
+export * from "./crosslink-scorer";
+export * from "./instant-matrix-search";
+export * from "./rss-syndication-feed";
+export * from "./embeddable-seo-widget";
+export * from "./ngram-density-analyzer";
+export * from "./isr-cache-manager";
+export * from "./llm-content-cleaner";
+export * from "./copy-frameworks-master";
+export * from "./social-ads-seo";
+export * from "./ad-intelligence-cro";
+export * from "./rank-math-parity";
+export * from "./yoast-parity";
+export * from "./social-growth-suite";
+export * from "./team-rbac";
+export * from "./real-reviews-sync";
 import { LynxSeoEngine, type EngineConfig } from "./engine";
 import { ApiKeyGuardian } from "./auth-key";
 import { TokenQuotaManager } from "./token-quota-manager";
@@ -30,6 +62,34 @@ import { IndexNowClient } from "./indexnow-client";
 import { SiteAuditor } from "./site-auditor";
 import { DeepCrawlerAuditor } from "./site-crawler";
 import { SchemaGraphBuilder } from "./schema-builder";
+import { ExtendedSchemaGraphBuilder } from "./extended-schemas";
+import { GeoMeshLinkingEngine } from "./geo-mesh-linking";
+import { BrandDnaCalendarEngine } from "./brand-dna-calendar";
+import { TechnicalRulesAuditor } from "./technical-rules-auditor";
+import { AiBotsLogAnalyzer } from "./ai-bots-log-analyzer";
+import { SerpRankHistoryEngine } from "./serp-history-alerts";
+import { SeoOpportunitiesDecayDetector } from "./seo-opportunities-decay";
+import { KnowledgeGraphLinker } from "./knowledge-graph-linker";
+import { CroCopywritingEngine } from "./cro-copywriting-engine";
+import { McpSeoServerHub } from "./mcp-seo-server";
+import { MasterMarketingEngine } from "./master-marketing-engine";
+import { SocialVideoSeoAnalyticsEngine } from "./social-video-seo";
+import { SocialTrendSeoGenerator } from "./social-trend-seo";
+import { CrosslinkScorerEngine } from "./crosslink-scorer";
+import { InstantMatrixSearchEngine } from "./instant-matrix-search";
+import { RssSyndicationFeedGenerator } from "./rss-syndication-feed";
+import { EmbeddableSeoWidgetGenerator } from "./embeddable-seo-widget";
+import { NGramDensityAnalyzer } from "./ngram-density-analyzer";
+import { IsrCacheManager } from "./isr-cache-manager";
+import { LlmContentCleaner } from "./llm-content-cleaner";
+import { CopywritingFrameworksMaster } from "./copy-frameworks-master";
+import { SocialAdsSocialSeoEngine } from "./social-ads-seo";
+import { AdIntelligenceCroEngine } from "./ad-intelligence-cro";
+import { RankMathParityEngine } from "./rank-math-parity";
+import { YoastParityEngine } from "./yoast-parity";
+import { SocialGrowthSuite } from "./social-growth-suite";
+import { TeamRbacEngine } from "./team-rbac";
+import { RealReviewsSyncEngine } from "./real-reviews-sync";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -42,5 +102,33 @@ export declare const LynxSeo: {
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
     buildSchemaGraph: typeof SchemaGraphBuilder.buildGraph;
+    extendedSchemas: typeof ExtendedSchemaGraphBuilder;
+    geoMesh: typeof GeoMeshLinkingEngine;
+    brandDna: typeof BrandDnaCalendarEngine;
+    technicalAuditor: typeof TechnicalRulesAuditor;
+    aiBotsLogger: typeof AiBotsLogAnalyzer;
+    serpRankHistory: typeof SerpRankHistoryEngine;
+    opportunitiesDecay: typeof SeoOpportunitiesDecayDetector;
+    knowledgeGraph: typeof KnowledgeGraphLinker;
+    croCopywriting: typeof CroCopywritingEngine;
+    mcpServer: typeof McpSeoServerHub;
+    marketing: typeof MasterMarketingEngine;
+    socialVideo: typeof SocialVideoSeoAnalyticsEngine;
+    socialTrends: typeof SocialTrendSeoGenerator;
+    crosslinks: typeof CrosslinkScorerEngine;
+    instantSearch: typeof InstantMatrixSearchEngine;
+    rssFeed: typeof RssSyndicationFeedGenerator;
+    embeddableWidget: typeof EmbeddableSeoWidgetGenerator;
+    ngramDensity: typeof NGramDensityAnalyzer;
+    isrCache: typeof IsrCacheManager;
+    llmCleaner: typeof LlmContentCleaner;
+    copyFrameworks: typeof CopywritingFrameworksMaster;
+    socialAds: typeof SocialAdsSocialSeoEngine;
+    adIntelligence: typeof AdIntelligenceCroEngine;
+    rankMathScore: typeof RankMathParityEngine;
+    yoastReadability: typeof YoastParityEngine;
+    socialGrowth: typeof SocialGrowthSuite;
+    rbac: typeof TeamRbacEngine;
+    realReviews: typeof RealReviewsSyncEngine;
 };
 export default LynxSeo;