@lynxflow/seo-engine 2.1.1 → 2.3.0

package/README.md

@@ -4,7 +4,7 @@ High-Performance Universal Programmatic SEO & Structured Data Engine for Modern
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/License-Proprietary-green.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/Version-2.1.1-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
+[![Version](https://img.shields.io/badge/Version-2.3.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
 
 ---
 

package/dist/above-fold-cro-auditor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 🎯 Above-The-Fold & Landing Page CRO Auditor
+ * Evaluates hero sections and landing page conversion architecture (0-100 Score).
+ * Analyzes Value Proposition clarity, CTA strength, Trust signals, and Friction points.
+ */
+export interface AboveFoldAuditInput {
+    h1: string;
+    subheadline?: string;
+    primaryCtaText: string;
+    primaryCtaUrl?: string;
+    hasTestimonialsOrStars?: boolean;
+    hasRiskReversalOrGuarantee?: boolean;
+    hasCustomerLogos?: boolean;
+    pageContentSnippet?: string;
+}
+export interface CroCriterionResult {
+    name: string;
+    passed: boolean;
+    score: number;
+    feedback: string;
+}
+export interface AboveFoldCroReport {
+    croScore: number;
+    rating: "high_converting" | "solid" | "high_friction";
+    criteria: CroCriterionResult[];
+    recommendedFixes: string[];
+    suggestedHeroVariant: {
+        h1: string;
+        subheadline: string;
+        ctaText: string;
+        reassuranceBadge: string;
+    };
+}
+export declare class AboveFoldCroAuditor {
+    private static readonly STRONG_ACTION_VERBS;
+    private static readonly WEAK_ACTION_VERBS;
+    /**
+     * Audits hero section and returns a comprehensive CRO report.
+     */
+    static auditHero(input: AboveFoldAuditInput): AboveFoldCroReport;
+}

package/dist/aeo-snippet-synthesizer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 🤖 AEO Direct Answer & LLM Citation Synthesizer
+ * Generates compact, fact-dense direct answers (40-60 words) optimized for
+ * Perplexity, SearchGPT, Gemini AI Overviews, and Claude citations.
+ */
+export interface AeoDirectSnippetOptions {
+    brandName: string;
+    serviceName: string;
+    locationName?: string;
+    countryName?: string;
+    currencySymbol?: string;
+    startingPrice?: number;
+    keyBenefits?: string[];
+    entityCategory?: string;
+    language?: string;
+}
+export interface AeoDirectAnswerResult {
+    directAnswerText: string;
+    bulletPoints: string[];
+    statHighlight: string;
+    citationScore: number;
+    speakableText: string;
+}
+export declare class AeoSnippetSynthesizer {
+    /**
+     * Synthesizes a structured AEO direct answer block in < 0.01ms.
+     */
+    static synthesize(opts: AeoDirectSnippetOptions): AeoDirectAnswerResult;
+}

package/dist/context-templates-generator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 📁 Context Templates Generator for AI Coding Agents
+ * Automatically generates production-ready markdown configuration templates
+ * (.claude/ and context/ directories) for Claude Code, Cursor, and Antigravity.
+ */
+export interface BrandContextInput {
+    brandName: string;
+    domain: string;
+    industry: string;
+    coreFeatures: string[];
+    targetAudience: string;
+    primaryKeywords: string[];
+}
+export declare class ContextTemplatesGenerator {
+    /**
+     * Generates a complete bundle of 8 context markdown files tailored to a brand.
+     */
+    static generateAllContextFiles(input: BrandContextInput): Record<string, string>;
+    static generateBrandVoice(input: BrandContextInput): string;
+    static generateFeatures(input: BrandContextInput): string;
+    static generateInternalLinksMap(input: BrandContextInput): string;
+    static generateStyleGuide(input: BrandContextInput): string;
+    static generateTargetKeywords(input: BrandContextInput): string;
+    static generateCompetitorAnalysis(input: BrandContextInput): string;
+    static generateSeoGuidelines(input: BrandContextInput): string;
+    static generateCroBestPractices(input: BrandContextInput): string;
+}

package/dist/google-indexing-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ⚡ Google Indexing API Batch Client
+ * Directly notifies Googlebot of URL updates, additions, and deletions for immediate crawling.
+ * Integrates with Service Account credentials and automatic batch quota management.
+ */
+export interface GoogleIndexingPayload {
+    url: string;
+    type: "URL_UPDATED" | "URL_DELETED";
+}
+export interface GoogleIndexingResult {
+    url: string;
+    type: "URL_UPDATED" | "URL_DELETED";
+    status: "submitted" | "queued" | "rate_limited" | "error";
+    notifyTime?: string;
+    message?: string;
+}
+export interface GoogleIndexingBatchSummary {
+    totalRequested: number;
+    submittedCount: number;
+    queuedCount: number;
+    rateLimitedCount: number;
+    results: GoogleIndexingResult[];
+}
+export declare class GoogleIndexingClient {
+    private static readonly GOOGLE_INDEXING_ENDPOINT;
+    private static readonly DAILY_QUOTA_LIMIT;
+    /**
+     * Submits a single URL to Google Indexing API.
+     */
+    static submitUrl(url: string, type?: "URL_UPDATED" | "URL_DELETED", options?: {
+        accessToken?: string;
+        proxyUrl?: string;
+    }): Promise<GoogleIndexingResult>;
+    /**
+     * Submits a batch of URLs with rate limiting and quota protection.
+     */
+    static submitBatch(urls: string[] | GoogleIndexingPayload[], options?: {
+        accessToken?: string;
+        proxyUrl?: string;
+        maxBatchSize?: number;
+    }): Promise<GoogleIndexingBatchSummary>;
+}

package/dist/humanity-ai-scrubber.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 🧹 Humanity AI Scrubber & Anti-AI Watermark Engine
+ * Detects and removes robotic LLM patterns, clichés, em-dash abuses, and filler phrases.
+ * Computes a rigorous Humanity Score (0-100) and produces humanized copy.
+ */
+export interface AiClichéMatch {
+    pattern: string;
+    count: number;
+    category: "filler_word" | "robotic_intro" | "excessive_punctuation" | "overused_transition";
+    suggestion: string;
+}
+export interface HumanityScrubReport {
+    humanityScore: number;
+    aiProbabilityScore: number;
+    totalWords: number;
+    clichésDetectedCount: number;
+    clichés: AiClichéMatch[];
+    isHumanSounding: boolean;
+    scrubbedText: string;
+    improvementRecommendations: string[];
+}
+export declare class HumanityAiScrubber {
+    private static readonly BANNED_AI_WORDS;
+    private static readonly ROBOTIC_INTROS;
+    /**
+     * Analyzes text and returns a comprehensive Humanity Score and scrubbed output.
+     */
+    static analyzeAndScrub(text: string, language?: string): HumanityScrubReport;
+}

package/dist/index.d.ts

@@ -111,6 +111,14 @@ import { InternalPageRankEngine } from "./internal-pagerank-graph";
 import { GeoCitationScorer } from "./geo-citation-scorer";
 import { MarketingSkillsEngine } from "./marketing-skills-engine";
 import { PageRegenerationTracker } from "./generation-tracker";
+import { GoogleIndexingClient } from "./google-indexing-client";
+import { AeoSnippetSynthesizer } from "./aeo-snippet-synthesizer";
+import { SemanticCannibalizationDetector } from "./semantic-cannibalization";
+import { HumanityAiScrubber } from "./humanity-ai-scrubber";
+import { SerpLengthComparator } from "./serp-length-comparator";
+import { PassiveVoiceComplexityAnalyzer } from "./passive-voice-complexity";
+import { AboveFoldCroAuditor } from "./above-fold-cro-auditor";
+import { ContextTemplatesGenerator } from "./context-templates-generator";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -119,6 +127,14 @@ export declare const LynxSeo: {
     createLagoMeter: (apiKey?: string, lagoUrl?: string) => LagoTokenMeter;
     createHyperswitchGateway: (apiKey: string, baseUrl?: string) => HyperswitchGateway;
     submitToIndexNow: typeof IndexNowClient.submitUrls;
+    googleIndexing: typeof GoogleIndexingClient;
+    aeoSnippet: typeof AeoSnippetSynthesizer;
+    cannibalization: typeof SemanticCannibalizationDetector;
+    humanityScrubber: typeof HumanityAiScrubber;
+    serpLength: typeof SerpLengthComparator;
+    readabilityComplexity: typeof PassiveVoiceComplexityAnalyzer;
+    aboveFoldCro: typeof AboveFoldCroAuditor;
+    contextTemplates: typeof ContextTemplatesGenerator;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -160,6 +176,14 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./humanity-ai-scrubber";
+export * from "./serp-length-comparator";
+export * from "./passive-voice-complexity";
+export * from "./above-fold-cro-auditor";
+export * from "./context-templates-generator";
+export * from "./google-indexing-client";
+export * from "./aeo-snippet-synthesizer";
+export * from "./semantic-cannibalization";
 export * from "./generation-tracker";
 export * from "./internal-pagerank-graph";
 export * from "./geo-citation-scorer";