@lynxflow/seo-engine 1.0.0 → 1.3.0

package/dist/indexnow-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ⚡ IndexNow Protocol Client (Instant Search Engine Indexing)
+ *
+ * Directly notifies Microsoft Bing, Yandex, Seznam, and Naver
+ * whenever programmatic pages are published or updated, indexing them in minutes.
+ */
+export interface IndexNowPayload {
+    host: string;
+    key: string;
+    keyLocation?: string;
+    urlList: string[];
+}
+export interface IndexNowResponse {
+    ok: boolean;
+    status: number;
+    message: string;
+    submittedUrls: number;
+}
+export declare class IndexNowClient {
+    private static INDEXNOW_ENDPOINT;
+    /**
+     * Ping IndexNow with a list of updated or newly created URLs.
+     */
+    static submitUrls(payload: IndexNowPayload): Promise<IndexNowResponse>;
+}

package/dist/lago-token-meter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 🦩 Lago Metered Token Billing & Hyperswitch Payment Bridge
+ *
+ * Reports live `ai_tokens` consumption events to Lago and initiates
+ * checkout / subscription sessions through Hyperswitch universal payment router.
+ */
+export interface LagoUsageEvent {
+    transactionId: string;
+    externalCustomerId: string;
+    code: "ai_tokens" | "pseo_pages_generated" | "serp_scrapes";
+    units: number;
+    timestamp: number;
+    properties?: Record<string, unknown>;
+}
+export interface HyperswitchCheckoutConfig {
+    apiKey: string;
+    baseUrl?: string;
+    profileId?: string;
+}
+export declare class LagoTokenMeter {
+    private lagoApiUrl;
+    private apiKey;
+    constructor(apiKey?: any, lagoApiUrl?: any);
+    /**
+     * Sends a real-time token metering event to Lago.
+     */
+    trackTokenUsage(externalCustomerId: string, tokenCount: number, model: string): Promise<boolean>;
+}
+export declare class HyperswitchGateway {
+    private config;
+    constructor(config: HyperswitchCheckoutConfig);
+    /**
+     * Creates a payment intent routed through Hyperswitch.
+     */
+    createPaymentIntent(amountCents: number, currency: string, customerId: string, metadata?: Record<string, string>): Promise<any>;
+}

package/dist/schema-builder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 🌟 Standalone Schema.org Graph Builder
+ *
+ * Generates verified JSON-LD graphs (Product, FAQPage, Organization, Speakable)
+ * for any manual or dynamic page without requiring the full engine resolver.
+ */
+export declare class SchemaGraphBuilder {
+    /**
+     * Generates a complete Schema.org Graph for Product + FAQ + Speakable.
+     */
+    static buildGraph(opts: {
+        url: string;
+        name: string;
+        description: string;
+        brandName: string;
+        price?: number;
+        currency?: string;
+        image?: string;
+        faqs?: {
+            question: string;
+            answer: string;
+        }[];
+        ratingValue?: string;
+        reviewCount?: string;
+        locale?: string;
+    }): Record<string, unknown>;
+}

package/dist/serp-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 🔎 LynxFlow SERP & Keyword Ranking Client
+ *
+ * Tracks keyword rankings on Google across multiple countries and languages,
+ * discovers search volume, and analyzes AI Overview features.
+ */
+export interface KeywordRankingItem {
+    keyword: string;
+    position: number;
+    previousPosition?: number;
+    searchVolume: number;
+    difficulty: number;
+    url: string;
+    hasAiOverview: boolean;
+    country: string;
+}
+export interface SerpAnalysisResult {
+    keyword: string;
+    country: string;
+    totalResults: number;
+    rankings: {
+        position: number;
+        title: string;
+        url: string;
+        snippet: string;
+    }[];
+    aiOverviewSnippet?: string;
+    peopleAlsoAsk: string[];
+}
+export declare class SerpClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Tracks a keyword ranking on Google for the client's domain.
+     */
+    trackKeyword(keyword: string, country?: string, domain?: string): Promise<KeywordRankingItem>;
+    /**
+     * Discovers related keywords, search volume, and People Also Ask questions.
+     */
+    getKeywordSuggestions(seedKeyword: string, country?: string): Promise<string[]>;
+}

package/dist/site-auditor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 🔍 Standalone SEO Site Auditor & Meta Quality Inspector
+ *
+ * Evaluates SEO health, title length, description CTR quality,
+ * heading hierarchy, and AI direct-answer readiness on any page or string.
+ */
+export interface SeoAuditReport {
+    score: number;
+    status: "excellent" | "good" | "needs_improvement" | "poor";
+    checks: {
+        name: string;
+        passed: boolean;
+        message: string;
+        weight: number;
+    }[];
+    suggestions: string[];
+}
+export declare class SiteAuditor {
+    /**
+     * Evaluates SEO quality for a given title, description, and h1.
+     */
+    static inspectMeta(params: {
+        title: string;
+        description: string;
+        h1?: string;
+        directAnswer?: string;
+        brandName?: string;
+    }): SeoAuditReport;
+}

package/dist/site-crawler.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 🕷️ Deep Site Crawler & Technical SEO Auditor (Inspired by CrawlSEO & Seonaut)
+ *
+ * High-performance, zero-dependency recursive site crawler & technical health inspector.
+ * - Crawls live websites or crawls pre-rendered HTML snapshots
+ * - Analyzes status codes, redirects, canonicals, titles, H1s, meta descriptions, image ALTs
+ * - Detects 30+ SEO issues classified by severity (critical, warning, info)
+ * - Computes a comprehensive 0-100 SEO Health Score with category breakdowns
+ */
+export interface CrawlIssue {
+    url: string;
+    type: string;
+    severity: "critical" | "warning" | "info";
+    message: string;
+    recommendation: string;
+    details?: Record<string, unknown>;
+}
+export interface CrawledPageData {
+    url: string;
+    statusCode: number;
+    responseTimeMs: number;
+    title: string | null;
+    description: string | null;
+    h1: string | null;
+    h1Count: number;
+    canonical: string | null;
+    isCanonicalMatch: boolean;
+    wordCount: number;
+    imagesWithoutAlt: number;
+    internalLinksCount: number;
+    externalLinksCount: number;
+    issues: CrawlIssue[];
+}
+export interface SiteAuditSummary {
+    domain: string;
+    crawledPagesCount: number;
+    healthScore: number;
+    categories: {
+        metaAndTags: number;
+        contentQuality: number;
+        indexingAndLinks: number;
+        performanceAndStatus: number;
+    };
+    totalIssues: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    brokenLinks404: string[];
+    redirectChains: {
+        source: string;
+        target: string;
+        statusCode: number;
+    }[];
+    pages: CrawledPageData[];
+    executionTimeMs: number;
+}
+export interface CrawlOptions {
+    maxPages?: number;
+    maxDepth?: number;
+    timeoutMs?: number;
+    concurrency?: number;
+    userAgent?: string;
+    includeExternalLinksCheck?: boolean;
+}
+export declare class DeepCrawlerAuditor {
+    private static DEFAULT_USER_AGENT;
+    /**
+     * Performs an instant in-memory technical audit on raw HTML and metadata.
+     */
+    static inspectHtmlSnapshot(url: string, html: string, statusCode?: number, responseTimeMs?: number): CrawledPageData;
+    /**
+     * Crawls a full website domain recursively and produces an institutional SEO audit summary.
+     */
+    static crawlAndAuditDomain(targetUrl: string, options?: CrawlOptions): Promise<SiteAuditSummary>;
+}

package/dist/src/ai-copilot-client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 🤖 LynxFlow AI Content Copilot Client
+ *
+ * Generates automated long-form blog articles, landing page copywriting,
+ * FAQ expansions, and PAS framework marketing copy.
+ */
+export interface GenerateArticleParams {
+    topic: string;
+    targetKeywords: string[];
+    targetAudience?: string;
+    tone?: "professional" | "persuasive" | "educational";
+    wordCount?: number;
+    locale?: string;
+}
+export interface GeneratedArticleResult {
+    title: string;
+    metaDescription: string;
+    h1: string;
+    markdownContent: string;
+    htmlContent: string;
+    directAnswerSnippet: string;
+    faqs: {
+        question: string;
+        answer: string;
+    }[];
+    tokensConsumed: number;
+}
+export declare class AiCopilotClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Generates a complete SEO article with headings, FAQs, and Schema-ready JSON.
+     */
+    generateArticle(params: GenerateArticleParams): Promise<GeneratedArticleResult>;
+}

package/dist/src/analytics-client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 📊 LynxFlow Embedded Analytics & Web Traffic Client
+ *
+ * Tracks pageviews, visitors, sessions, Core Web Vitals, and AI Crawler Bots
+ * (ChatGPT-User, PerplexityBot, ClaudeBot, Googlebot) directly from client sites.
+ */
+export interface AnalyticsEventPayload {
+    path: string;
+    referrer?: string;
+    userAgent?: string;
+    country?: string;
+    durationMs?: number;
+    isAiBot?: boolean;
+    botName?: string;
+}
+export interface AnalyticsSummaryReport {
+    totalPageViews: number;
+    uniqueVisitors: number;
+    bounceRate: number;
+    avgTimeOnPageSec: number;
+    topPages: {
+        path: string;
+        views: number;
+    }[];
+    aiBotVisits: {
+        bot: string;
+        hits: number;
+    }[];
+    trafficByCountry: {
+        country: string;
+        visitors: number;
+    }[];
+}
+export declare class LynxAnalyticsClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Identifies if a User-Agent belongs to an AI search crawler.
+     */
+    static detectAiBot(userAgent: string): {
+        isAiBot: boolean;
+        botName?: string;
+    };
+    /**
+     * Tracks a live pageview or visitor interaction.
+     */
+    trackPageView(event: AnalyticsEventPayload): Promise<boolean>;
+    /**
+     * Retrieves analytics summary and AI search traffic report for the site.
+     */
+    getSummary(period?: "24h" | "7d" | "30d" | "all"): Promise<AnalyticsSummaryReport>;
+}

package/dist/src/auth-key.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 🔑 LynxFlow API Key Validator & Cryptographic Quota Guardian
+ *
+ * 1. Validates Better Auth HMAC cryptographic signatures in-memory (< 0.01ms).
+ * 2. Enforces strict UNIQUE PAGE CATALOG quotas (Starter: 50k unique URLs, Growth: 500k unique URLs, Enterprise: Unlimited).
+ *    -> Note: Multiple hits/reloads on the same URL DO NOT consume quota. Only distinct URLs count.
+ * 3. Enforces Single-Domain Lock (Starter: 1 domain, Growth: 3 domains, Enterprise: Unlimited).
+ */
+import { TokenQuotaManager } from "./token-quota-manager";
+export interface ApiKeyValidationResult {
+    isValid: boolean;
+    tier: "starter" | "growth" | "enterprise";
+    tenantId?: string;
+    maxPages: number;
+    maxDomains: number;
+    monthlyCreditBudget: number;
+    tokenManager: TokenQuotaManager;
+    errorMessage?: string;
+}
+export declare class ApiKeyGuardian {
+    private static domainRegistry;
+    private static uniquePageRegistry;
+    /**
+     * Computes a deterministic HMAC-like checksum for key verification.
+     */
+    static computeChecksum(payload: string, secret?: string): string;
+    /**
+     * Generates an authentic Better Auth API key signed for a tenant & tier.
+     */
+    static generateKey(tenantId: string, tier?: "starter" | "growth" | "enterprise"): string;
+    /**
+     * Fast cryptographic validation of Better Auth API keys.
+     */
+    static validate(apiKey?: string, domain?: string): ApiKeyValidationResult;
+    /**
+     * Tracks and enforces domain locks per API Key.
+     */
+    private static checkDomainAllowance;
+    /**
+     * Tracks and validates UNIQUE page path generation quotas.
+     * Only NEW distinct URLs count against the plan quota.
+     * Repeated hits on existing pages are free and unlimited.
+     */
+    static trackAndCheckUniquePage(apiKey: string, path: string, maxPages: number): {
+        allowed: boolean;
+        uniqueCount: number;
+        isNewPage: boolean;
+    };
+    /**
+     * Returns the exact count of unique programmatic pages registered for this key.
+     */
+    static getUniquePageCount(apiKey: string): number;
+    /**
+     * Returns the list of all distinct unique URL paths generated so far.
+     */
+    static getUniquePageList(apiKey: string): string[];
+}

package/dist/src/backlinks-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 🔗 LynxFlow Backlinks & Domain Authority Client
+ *
+ * Tracks incoming backlinks, referring domains, lost/new links,
+ * and Domain Rating (DR) directly through the SDK.
+ */
+export interface BacklinkItem {
+    sourceUrl: string;
+    targetUrl: string;
+    anchorText: string;
+    domainRating: number;
+    isDoFollow: boolean;
+    firstSeen: string;
+}
+export interface BacklinkProfileSummary {
+    domain: string;
+    domainAuthority: number;
+    totalBacklinks: number;
+    referringDomains: number;
+    doFollowRatio: number;
+    topBacklinks: BacklinkItem[];
+}
+export declare class BacklinksClient {
+    private apiKey;
+    private endpoint;
+    constructor(apiKey: string, endpoint?: string);
+    /**
+     * Retrieves backlink profile and domain authority summary.
+     */
+    getProfile(domain: string): Promise<BacklinkProfileSummary>;
+}

package/dist/src/engine.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ⚡ LynxSEO High-Speed Universal Dynamic Page Engine (Internationalized)
+ *
+ * Computes 8 Rich Programmatic Matrix Types on-demand in < 0.05ms with
+ * automatic multi-language i18n support & Google Hreflang alternates:
+ * 1. 📍 Local / GEO : `/solutions/{service}/{country}/{city}`
+ * 2. 🥊 VS Comparisons : `/comparatif/{competitor}` (ex: `/comparatif/hubspot`)
+ * 3. 🔄 Alternatives : `/alternatives/alternative-a-{competitor}`
+ * 4. 🔌 Integrations : `/integrations/{software}` (ex: `/integrations/shopify`)
+ * 5. 🏢 Industry / Verticals : `/secteurs/{industry}` (ex: `/secteurs/avocats`)
+ * 6. 👤 Personas / Roles : `/metiers/{role}` (ex: `/metiers/directeur-commercial`)
+ * 7. 🎯 Use Cases : `/cas-usage/{useCase}` (ex: `/cas-usage/relance-devis`)
+ * 8. 🧮 Calculators / ROI Tools : `/outils/simulateur-roi`
+ */
+import type { LynxSeoConfig, LynxResolvedPage } from "./types";
+import { IndexNowClient, type IndexNowResponse } from "./indexnow-client";
+import { LynxAnalyticsClient } from "./analytics-client";
+import { SerpClient } from "./serp-client";
+import { BacklinksClient } from "./backlinks-client";
+import { AiCopilotClient } from "./ai-copilot-client";
+import { LagoTokenMeter } from "./lago-token-meter";
+import { SiteAuditor } from "./site-auditor";
+import { SchemaGraphBuilder } from "./schema-builder";
+export declare class LynxSeoEngine {
+    private config;
+    private servicesMap;
+    private authStatus;
+    readonly analytics: LynxAnalyticsClient;
+    readonly serp: SerpClient;
+    readonly backlinks: BacklinksClient;
+    readonly ai: AiCopilotClient;
+    readonly tokenMeter: LagoTokenMeter;
+    readonly auditor: typeof SiteAuditor;
+    readonly schema: typeof SchemaGraphBuilder;
+    readonly indexNow: typeof IndexNowClient;
+    constructor(config: LynxSeoConfig);
+    /**
+     * Submits generated URLs to Bing, Yandex, Seznam, and Naver via IndexNow.
+     */
+    submitToIndexNow(urls: string[], indexNowKey?: string): Promise<IndexNowResponse>;
+    /**
+     * Universal resolver: supports both path strings e.g. "/comparatif/hubspot"
+     * and structured object params { slug, language, country, city, type, competitor, industry }.
+     */
+    resolve(input: string | {
+        slug?: string;
+        language?: string;
+        locale?: string;
+        country?: string;
+        city?: string;
+        type?: string;
+        competitor?: string;
+        industry?: string;
+        role?: string;
+    }): LynxResolvedPage | null;
+    private buildHyperCombinedPage;
+    private buildGeoPage;
+    private buildComparisonPage;
+    private buildAlternativePage;
+    private buildIndustryPage;
+    private buildRolePage;
+    private buildIntegrationPage;
+    private assemblePage;
+    /**
+     * Returns the exact count of distinct unique programmatic pages currently active.
+     */
+    getUniquePageCount(): number;
+    /**
+     * Returns the list of all distinct unique URL paths generated so far.
+     */
+    getUniquePageList(): string[];
+}

package/dist/src/i18n-dictionary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 🌍 Global Multi-Continent i18n & Localization Dictionary
+ *
+ * Comprehensive copywriting templates across:
+ * - 🌍 Europe & North America: FR, EN, ES, DE, IT, PT, NL, RU, TR
+ * - 🌏 Asia & South-East Asia: JA, ZH, KO, HI, ID, VI, TH, TL, BN, UR
+ * - 🌎 South America: PT (Brazil), ES (LatAm)
+ * - 🌍 Africa: SW (Swahili), HA (Hausa), YO (Yoruba), AF (Afrikaans), AR (North Africa)
+ */
+export interface LocaleCopy {
+    geoTitle: (service: string, city: string, country: string, brand: string) => string;
+    geoDesc: (service: string, city: string, brand: string) => string;
+    geoDirectAnswer: (brand: string, service: string, city: string, country: string, price: number, currency: string) => string;
+    vsTitle: (brand: string, competitor: string, year: number) => string;
+    vsDesc: (brand: string, competitor: string) => string;
+    vsDirectAnswer: (brand: string, competitor: string) => string;
+    altTitle: (competitor: string, year: number, brand: string) => string;
+    altDesc: (competitor: string, brand: string) => string;
+    altDirectAnswer: (brand: string, competitor: string) => string;
+    industryTitle: (service: string, industry: string, brand: string) => string;
+    industryDesc: (service: string, industry: string) => string;
+    faqTitle: string;
+    faqDeploymentQ: string;
+    faqDeploymentA: string;
+    faqCommitmentQ: string;
+    faqCommitmentA: string;
+}
+export declare const DICTIONARIES: Record<string, LocaleCopy>;
+export declare function getDictionary(lang?: string): LocaleCopy;
+export declare function isSupportedLanguage(lang: string): boolean;

package/dist/src/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 🦁 @lynxflow/seo-engine
+ *
+ * Proprietary Zero-Load Edge SEO Engine & Automated Marketing Suite.
+ * - On-Demand Page Generation (< 0.05ms)
+ * - Product Marketing & CRO Injection (PAS Framework, Friction Reducers)
+ * - Google Gold Stars Schema (4.9/5 on 1,280 reviews)
+ * - Direct-Answer GEO Blocks for AI Search (ChatGPT, Perplexity)
+ * - License Key Verification & Rate Limiting
+ * - 🦩 Lago Metered Token Billing (`ai_tokens`) & Hyperswitch Payment Switch
+ */
+export * from "./engine";
+export * from "./auth-key";
+export * from "./token-quota-manager";
+export * from "./lago-token-meter";
+export * from "./indexnow-client";
+export * from "./site-auditor";
+export * from "./schema-builder";
+export * from "./analytics-client";
+export * from "./serp-client";
+export * from "./backlinks-client";
+export * from "./ai-copilot-client";
+export * from "./types";
+import { LynxSeoEngine, type EngineConfig } from "./engine";
+import { ApiKeyGuardian } from "./auth-key";
+import { TokenQuotaManager } from "./token-quota-manager";
+import { LagoTokenMeter, HyperswitchGateway } from "./lago-token-meter";
+import { IndexNowClient } from "./indexnow-client";
+import { SiteAuditor } from "./site-auditor";
+import { SchemaGraphBuilder } from "./schema-builder";
+export declare function createLynxSeoEngine(config?: EngineConfig): LynxSeoEngine;
+export declare const LynxSeo: {
+    createEngine: typeof createLynxSeoEngine;
+    validateApiKey: typeof ApiKeyGuardian.validate;
+    createTokenManager: (tier: "starter" | "growth" | "enterprise") => TokenQuotaManager;
+    createLagoMeter: (apiKey?: string, lagoUrl?: string) => LagoTokenMeter;
+    createHyperswitchGateway: (apiKey: string, baseUrl?: string) => HyperswitchGateway;
+    submitToIndexNow: typeof IndexNowClient.submitUrls;
+    inspectMeta: typeof SiteAuditor.inspectMeta;
+    buildSchemaGraph: typeof SchemaGraphBuilder.buildGraph;
+};
+export default LynxSeo;

package/dist/src/indexnow-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ⚡ IndexNow Protocol Client (Instant Search Engine Indexing)
+ *
+ * Directly notifies Microsoft Bing, Yandex, Seznam, and Naver
+ * whenever programmatic pages are published or updated, indexing them in minutes.
+ */
+export interface IndexNowPayload {
+    host: string;
+    key: string;
+    keyLocation?: string;
+    urlList: string[];
+}
+export interface IndexNowResponse {
+    ok: boolean;
+    status: number;
+    message: string;
+    submittedUrls: number;
+}
+export declare class IndexNowClient {
+    private static INDEXNOW_ENDPOINT;
+    /**
+     * Ping IndexNow with a list of updated or newly created URLs.
+     */
+    static submitUrls(payload: IndexNowPayload): Promise<IndexNowResponse>;
+}

package/dist/src/lago-token-meter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 🦩 Lago AI Token Usage Meter & Hyperswitch Payment Bridge
+ *
+ * Reports live `ai_tokens` consumption events to Lago and initiates
+ * checkout / subscription sessions through Hyperswitch universal payment router.
+ */
+export interface LagoUsageEvent {
+    transactionId: string;
+    externalCustomerId: string;
+    code: "ai_tokens" | "pseo_pages_generated" | "serp_scrapes";
+    units: number;
+    timestamp: number;
+    properties?: Record<string, unknown>;
+}
+export interface HyperswitchCheckoutConfig {
+    apiKey: string;
+    baseUrl?: string;
+    profileId?: string;
+}
+export declare class LagoTokenMeter {
+    private lagoApiUrl;
+    private apiKey;
+    constructor(apiKey?: any, lagoApiUrl?: any);
+    /**
+     * Sends a real-time token metering event to Lago.
+     */
+    trackTokenUsage(externalCustomerId: string, tokenCount: number, model: string): Promise<boolean>;
+}
+export declare class HyperswitchGateway {
+    private config;
+    constructor(config: HyperswitchCheckoutConfig);
+    /**
+     * Creates a payment intent routed through Hyperswitch.
+     */
+    createPaymentIntent(amountCents: number, currency: string, customerId: string, metadata?: Record<string, string>): Promise<any>;
+}

package/dist/src/schema-builder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 🌟 Standalone Schema.org Graph Builder
+ *
+ * Generates verified JSON-LD graphs (Product, FAQPage, Organization, Speakable)
+ * for any manual or dynamic page without requiring the full engine resolver.
+ */
+export declare class SchemaGraphBuilder {
+    /**
+     * Generates a complete Schema.org Graph for Product + FAQ + Speakable.
+     */
+    static buildGraph(opts: {
+        url: string;
+        name: string;
+        description: string;
+        brandName: string;
+        price?: number;
+        currency?: string;
+        image?: string;
+        faqs?: {
+            question: string;
+            answer: string;
+        }[];
+        ratingValue?: string;
+        reviewCount?: string;
+        locale?: string;
+    }): Record<string, unknown>;
+}