@prenta/core 0.118.0

package/dist/seo/audit-runner.js

@@ -0,0 +1,372 @@
+/**
+ * SEO audit orchestration: gather content from the DB, run the pure analysis
+ * engine, and persist a `SeoAuditRun` snapshot plus the live `SeoIssue` set.
+ *
+ * Issue lifecycle (carried across runs by `issueKey`):
+ *   - newly detected            -> status `open`
+ *   - detected + was `ignored`  -> stays `ignored`
+ *   - detected + was `resolved` -> `recurring`
+ *   - detected + open/recurring -> unchanged (lastDetectedAt bumped)
+ *   - NOT detected + open/recurring -> auto `resolved` (resolvedAt set)
+ *   - NOT detected + ignored/resolved -> unchanged
+ *
+ * The run row stores the score + counts snapshot, so audit *history* is the
+ * sequence of runs while the issue table reflects current state.
+ */
+import { runSeoAuditAnalysis, } from './audit-engine.js';
+import { resolveSeoModuleSettings, getSeoOverrides, applySeoOverrides, SEO_CONFIG_COLLECTION, } from './config-store.js';
+import { gatherAuditSignals } from './audit-signals.js';
+import { findInBatches } from '../db/find-in-batches.js';
+import { getPrentaConfig } from '../config/runtime.js';
+import { resolveDocumentUrl, resolveEffectiveCanonicalUrl, resolveEffectiveMeta, } from './page-meta.js';
+import { documentContentForSeoAnalysis } from './document-content.js';
+import { resolveEffectiveSchemaType } from './schema-sync.js';
+/** Collections that are never audited (internal/system data). */
+const EXCLUDED_COLLECTIONS = new Set([
+    SEO_CONFIG_COLLECTION,
+    'page-tags',
+    'redirects',
+    '__seo_config__',
+]);
+/**
+ * True for internal/system collections that must never be exposed on public
+ * surfaces (audit, `/llms.txt`, etc.). Covers the explicit exclude list plus
+ * any `__`-prefixed convention collection (e.g. `__seo_config__`, `__seo_perf__`).
+ */
+export function isInternalCollection(collection) {
+    return EXCLUDED_COLLECTIONS.has(collection) || String(collection).startsWith('__');
+}
+/**
+ * Derive the set of front-end **content** collections (and each one's page/post
+ * type) from the resolved CMS config. These are the only collections the SEO
+ * tools (Content SEO list, audit, scan, internal-link candidates) operate on.
+ *
+ * A collection qualifies only when it is:
+ *   - explicitly typed `page` or `post` (i.e. a publicly-rendered content type),
+ *   - not hidden from the admin (`admin.hidden`),
+ *   - not excluded from the sitemap (collection- or site-level).
+ *
+ * This deliberately excludes structural/utility collections (navigation menus,
+ * footers, tags, templates, redirects) — which have no `type` — as well as any
+ * document whose collection isn't declared in the config at all (e.g. benchmark
+ * or other ad-hoc rows that only exist in the database). The result is that the
+ * SEO surfaces show real front-end pages/posts/landing pages and nothing else.
+ */
+export function frontEndContentCollectionTypes(cfg) {
+    const out = {};
+    const config = (cfg ?? {});
+    const collections = config.collections ?? {};
+    const excluded = new Set(config.seo?.sitemap?.excludeCollections ?? []);
+    for (const [slug, col] of Object.entries(collections)) {
+        if (col?.type !== 'page' && col?.type !== 'post')
+            continue;
+        if (col?.admin?.hidden)
+            continue;
+        if (excluded.has(slug))
+            continue;
+        if (col?.seo?.excludeFromSitemap)
+            continue;
+        out[slug] = col.type;
+    }
+    return out;
+}
+/**
+ * Upper bound on documents loaded into a single audit pass. Audits hold the
+ * full entity set in memory and rescore each one, so an unbounded `findMany`
+ * is an OOM / latency risk on large instances. Sites past this cap should move
+ * to incremental/queued auditing.
+ */
+const AUDIT_MAX_ENTITIES = 5000;
+function asRecord(v) {
+    return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
+}
+function str(v) {
+    return typeof v === 'string' && v.length > 0 ? v : null;
+}
+/** Map a published document row into the audit engine's entity shape. */
+export function documentToAuditEntity(doc, collectionTypes, siteSeo) {
+    const data = asRecord(doc.data);
+    const structured = asRecord(doc.structuredData);
+    const slug = str(data.slug) ?? doc.slug ?? doc.id;
+    const config = getPrentaConfig();
+    const collectionDef = config?.collections?.[doc.collection];
+    const site = siteSeo ?? config?.seo;
+    const siteUrl = site?.siteUrl?.replace(/\/+$/, '') ?? '';
+    const url = resolveDocumentUrl({
+        siteUrl: '',
+        urlPrefix: collectionDef?.urlPrefix,
+        slug,
+        data,
+    });
+    const canonicalUrl = resolveEffectiveCanonicalUrl({
+        data,
+        siteUrl,
+        urlPrefix: collectionDef?.urlPrefix,
+        slug,
+    });
+    // SEO / readability / audit scoring must use a single-copy body — not
+    // `contentBlobForLinkScan`, which re-appends body/content and ~2× word counts (#671).
+    const content = documentContentForSeoAnalysis(doc);
+    // Prefer the configured collection type; fall back to the legacy heuristic
+    // (only `pages` is a page) when no config map is supplied.
+    const entityType = collectionTypes?.[doc.collection] ?? (doc.collection === 'pages' ? 'page' : 'post');
+    const structuredDataType = resolveEffectiveSchemaType({
+        collection: doc.collection,
+        data,
+        structuredData: structured,
+        collectionDef,
+    });
+    const effectiveMeta = resolveEffectiveMeta({
+        data,
+        docTitle: str(data.title) ?? doc.title,
+        publishedAt: doc.publishedAt,
+        collection: collectionDef,
+        collectionSlug: doc.collection,
+        site,
+        siteUrl,
+    });
+    return {
+        entityType,
+        entityId: doc.id,
+        title: str(data.title) ?? doc.title ?? 'Untitled',
+        url,
+        content,
+        metaTitle: effectiveMeta.metaTitle,
+        metaTitlePage: str(data.metaTitle) ?? str(data.seoTitle) ?? null,
+        metaDescription: effectiveMeta.metaDescription,
+        focusKeyword: str(data.focusKeyword) ?? str(data.focusKeyphrase),
+        keyTakeaway: str(data.keyTakeaway),
+        canonicalUrl,
+        ogTitle: str(data.ogTitle),
+        ogDescription: str(data.ogDescription),
+        ogImage: effectiveMeta.ogImage,
+        structuredDataType,
+        noindex: effectiveMeta.noindex,
+        shouldBeIndexable: true,
+        wordCount: typeof data.wordCount === 'number' ? data.wordCount : null,
+    };
+}
+export async function gatherAuditEntities(db, options = {}) {
+    const { collectionTypes } = options;
+    // When the caller knows the front-end content collections, scope the query to
+    // them at the DB level so structural/benchmark rows never even count against
+    // the entity cap.
+    const where = { deletedAt: null, status: 'PUBLISHED' };
+    if (collectionTypes) {
+        const slugs = Object.keys(collectionTypes);
+        if (slugs.length === 0)
+            return [];
+        where.collection = { in: slugs };
+    }
+    const docs = await db.document.findMany({
+        where,
+        select: {
+            id: true,
+            collection: true,
+            title: true,
+            slug: true,
+            data: true,
+            structuredData: true,
+            plainText: true,
+            publishedAt: true,
+        },
+        orderBy: { updatedAt: 'desc' },
+        take: AUDIT_MAX_ENTITIES,
+    });
+    const overrides = await getSeoOverrides(db).catch(() => null);
+    const mergedConfig = applySeoOverrides(getPrentaConfig(), overrides);
+    const siteSeo = mergedConfig?.seo;
+    return docs
+        .filter((d) => (collectionTypes ? true : !isInternalCollection(d.collection)))
+        .map((d) => documentToAuditEntity(d, collectionTypes, siteSeo));
+}
+/**
+ * Run an audit and persist the run + issue snapshot. Returns the run summary.
+ * Throws if the SEO models aren't available (caller maps to 501).
+ */
+export async function runAndPersistAudit(db, options = {}) {
+    if (!db?.seoAuditRun?.create || !db?.seoIssue?.findMany) {
+        throw new Error('SEO models not available');
+    }
+    const scope = options.scope ?? 'full';
+    const overrides = await getSeoOverrides(db).catch(() => null);
+    const moduleSettings = resolveSeoModuleSettings(overrides);
+    // Refuse to start when another audit is already RUNNING. Two concurrent
+    // runs both reconcile the shared SeoIssue table and can create duplicate
+    // rows for the same issueKey (it carries an index, not a unique constraint).
+    // A run older than the stale window is treated as crashed and ignored.
+    const STALE_RUN_MS = 15 * 60 * 1000;
+    const inFlight = await db.seoAuditRun
+        .findFirst({
+        where: { status: 'RUNNING' },
+        orderBy: { startedAt: 'desc' },
+        select: { startedAt: true },
+    })
+        .catch(() => null);
+    if (inFlight?.startedAt && Date.now() - new Date(inFlight.startedAt).getTime() < STALE_RUN_MS) {
+        throw new Error('An audit is already running');
+    }
+    // Previous run's after-score becomes this run's before-score.
+    const prev = await db.seoAuditRun.findFirst({
+        where: { status: 'COMPLETED' },
+        orderBy: { startedAt: 'desc' },
+        select: { siteScoreAfter: true },
+    });
+    const run = await db.seoAuditRun.create({
+        data: {
+            status: 'RUNNING',
+            scope,
+            startedById: options.startedById ?? null,
+            siteScoreBefore: prev?.siteScoreAfter ?? null,
+        },
+    });
+    try {
+        const entities = await gatherAuditEntities(db, { collectionTypes: options.collectionTypes });
+        const siteUrl = getPrentaConfig()?.seo?.siteUrl?.replace(/\/+$/, '');
+        const crossSignals = await gatherAuditSignals(db, entities, siteUrl);
+        const signals = {
+            sitemapEnabled: moduleSettings.sitemapEnabled,
+            robotsEnabled: moduleSettings.robotsEnabled,
+            ...crossSignals,
+            ...options.signals,
+        };
+        const result = runSeoAuditAnalysis(entities, signals);
+        await persistIssues(db, run.id, result.issues);
+        // Seed redirect recovery suggestions for legitimate broken paths and 404 hits.
+        {
+            const { generateRecoverySuggestions } = await import('../redirects/recovery.js');
+            const { normalizeRedirectPath } = await import('../redirects/graph.js');
+            const overrides = await getSeoOverrides(db).catch(() => null);
+            const moduleSettings = resolveSeoModuleSettings(overrides);
+            const pathPrefixes = Object.values(getPrentaConfig()?.collections ?? {})
+                .map((c) => {
+                const p = c?.urlPrefix ?? c?.slug;
+                return typeof p === 'string' && p.trim() ? normalizeRedirectPath(`/${p.trim()}`) : null;
+            })
+                .filter((p) => Boolean(p));
+            await generateRecoverySuggestions(db, {
+                candidates: entities.map((e) => ({ url: e.url, title: e.title })),
+                pathPrefixes,
+                brokenLinks: crossSignals.brokenLinks ?? [],
+                include404Hits: true,
+                siteUrl,
+                enableAiRerank: moduleSettings.redirectRecoveryAiRerank,
+                autoApply: moduleSettings.redirectRecoveryAutoApply,
+                autoApplyMinConfidence: moduleSettings.redirectRecoveryAutoApplyMinConfidence,
+            }).catch(() => { });
+        }
+        await db.seoAuditRun.update({
+            where: { id: run.id },
+            data: {
+                status: 'COMPLETED',
+                finishedAt: new Date(),
+                siteScoreAfter: result.siteScore.score,
+                pagesScanned: entities.length,
+                issuesFound: result.counts.total,
+                criticalCount: result.counts.critical,
+                warningCount: result.counts.warning,
+                infoCount: result.counts.info,
+                metadata: { breakdown: result.siteScore.breakdown },
+            },
+        });
+        return {
+            id: run.id,
+            status: 'COMPLETED',
+            siteScoreAfter: result.siteScore.score,
+            issuesFound: result.counts.total,
+            criticalCount: result.counts.critical,
+            warningCount: result.counts.warning,
+            infoCount: result.counts.info,
+            pagesScanned: entities.length,
+        };
+    }
+    catch (err) {
+        await db.seoAuditRun
+            .update({
+            where: { id: run.id },
+            data: {
+                status: 'FAILED',
+                finishedAt: new Date(),
+                errorMessage: err instanceof Error ? err.message : 'Audit failed',
+            },
+        })
+            .catch(() => { });
+        throw err;
+    }
+}
+/** Upsert detected issues and auto-resolve no-longer-detected ones. */
+async function persistIssues(db, auditRunId, detected) {
+    const existing = await findInBatches(({ take, cursor }) => db.seoIssue.findMany({
+        take,
+        ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+        orderBy: { id: 'asc' },
+        select: { id: true, issueKey: true, status: true, resolvedAt: true },
+    }));
+    const byKey = new Map(existing.map((i) => [i.issueKey, i]));
+    const detectedKeys = new Set(detected.map((d) => d.issueKey));
+    const now = new Date();
+    for (const issue of detected) {
+        const prior = byKey.get(issue.issueKey);
+        if (prior) {
+            let status = prior.status;
+            if (prior.status === 'resolved')
+                status = 'recurring';
+            // 'ignored' stays ignored; 'open'/'recurring' unchanged.
+            await db.seoIssue.update({
+                where: { id: prior.id },
+                data: {
+                    auditRunId,
+                    status,
+                    lastDetectedAt: now,
+                    entityTitle: issue.entityTitle,
+                    url: issue.url,
+                    severity: issue.severity,
+                    category: issue.category,
+                    title: issue.title,
+                    description: issue.description,
+                    impact: issue.impact,
+                    recommendation: issue.recommendation,
+                    fixable: issue.fixable,
+                    fixActionType: issue.fixActionType,
+                    relatedEntityIds: issue.relatedEntityIds,
+                    resolvedAt: status === 'resolved' ? prior.resolvedAt : null,
+                    ...(issue.metadata ? { metadata: issue.metadata } : {}),
+                },
+            });
+        }
+        else {
+            await db.seoIssue.create({
+                data: {
+                    auditRunId,
+                    issueKey: issue.issueKey,
+                    entityType: issue.entityType,
+                    entityId: issue.entityId,
+                    entityTitle: issue.entityTitle,
+                    url: issue.url,
+                    severity: issue.severity,
+                    category: issue.category,
+                    type: issue.type,
+                    title: issue.title,
+                    description: issue.description,
+                    impact: issue.impact,
+                    recommendation: issue.recommendation,
+                    status: 'open',
+                    fixable: issue.fixable,
+                    fixActionType: issue.fixActionType,
+                    relatedEntityIds: issue.relatedEntityIds,
+                    source: 'audit',
+                    ...(issue.metadata ? { metadata: issue.metadata } : {}),
+                },
+            });
+        }
+    }
+    // Auto-resolve open/recurring issues that were not detected this run.
+    const toResolve = existing.filter((i) => !detectedKeys.has(i.issueKey) && (i.status === 'open' || i.status === 'recurring'));
+    for (const i of toResolve) {
+        await db.seoIssue.update({
+            where: { id: i.id },
+            data: { status: 'resolved', resolvedAt: now },
+        });
+    }
+}
+//# sourceMappingURL=audit-runner.js.map

package/dist/seo/audit-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-runner.js","sourceRoot":"","sources":["../../src/seo/audit-runner.ts"],"names":[],"mappings":"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"}

package/dist/seo/audit-signals.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cross-cutting signals fed into `runSeoAuditAnalysis` — redirect health and
+ * broken-internal-link detection.
+ *
+ * Link checking is two-stage. `detectBrokenInternalLinks` resolves hrefs against
+ * CMS documents and redirect rules (cheap, but wrong for code-owned routes).
+ * `confirmBrokenLinksOverHttp` then probes the site origin; only confirmed
+ * 4xx/5xx survive. Without a site URL, no "returns 404" issues are raised —
+ * CMS resolution alone is not authoritative for hybrid/Astro sites.
+ */
+import type { RedirectRecord } from '../redirects/graph.js';
+import type { PrentaDB } from '../db/client-types.js';
+import type { AuditEntityInput, AuditExtraSignals } from './audit-engine.js';
+/** Count redirect chains and loops from stored redirect rules. */
+export declare function gatherRedirectSignals(db: PrentaDB): Promise<Pick<AuditExtraSignals, 'redirectChains' | 'redirectLoops'>>;
+/**
+ * Find internal links in content that don't resolve to a known page URL or
+ * redirect terminal. Static analysis only — does not fetch URLs. Callers that
+ * raise "returns 404" issues must pass the result through
+ * {@link confirmBrokenLinksOverHttp}.
+ */
+export declare function detectBrokenInternalLinks(entities: AuditEntityInput[], options?: {
+    siteUrl?: string;
+    redirectRules?: RedirectRecord[];
+}): AuditExtraSignals['brokenLinks'];
+/** Load redirect rules and gather all audit cross-cutting signals. */
+export declare function gatherAuditSignals(db: PrentaDB, entities: AuditEntityInput[], siteUrl?: string): Promise<AuditExtraSignals>;
+//# sourceMappingURL=audit-signals.d.ts.map

package/dist/seo/audit-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-signals.d.ts","sourceRoot":"","sources":["../../src/seo/audit-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAsB5E,kEAAkE;AAClE,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,GACX,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,eAAe,CAAC,CAAC,CA8BtE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,cAAc,EAAE,CAAA;CAAO,GACnE,iBAAiB,CAAC,aAAa,CAAC,CA4ClC;AAED,sEAAsE;AACtE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAgC5B"}

package/dist/seo/audit-signals.js

@@ -0,0 +1,133 @@
+/**
+ * Cross-cutting signals fed into `runSeoAuditAnalysis` — redirect health and
+ * broken-internal-link detection.
+ *
+ * Link checking is two-stage. `detectBrokenInternalLinks` resolves hrefs against
+ * CMS documents and redirect rules (cheap, but wrong for code-owned routes).
+ * `confirmBrokenLinksOverHttp` then probes the site origin; only confirmed
+ * 4xx/5xx survive. Without a site URL, no "returns 404" issues are raised —
+ * CMS resolution alone is not authoritative for hybrid/Astro sites.
+ */
+import { detectChainsAndLoops, normalizeRedirectPath, resolveChain, buildEdgeMap, } from '../redirects/graph.js';
+import { findInBatches } from '../db/find-in-batches.js';
+import { confirmBrokenLinksOverHttp } from './confirm-broken-links.js';
+const HREF_REGEX = /href=["']([^"']+)["']/gi;
+function normalizePath(path, siteUrl) {
+    const trimmed = path.trim();
+    if (!trimmed ||
+        trimmed.startsWith('#') ||
+        trimmed.startsWith('mailto:') ||
+        trimmed.startsWith('tel:'))
+        return null;
+    if (/^https?:\/\//i.test(trimmed)) {
+        const base = siteUrl.replace(/\/+$/, '').toLowerCase();
+        if (!base || !trimmed.toLowerCase().startsWith(base))
+            return null;
+        return normalizeRedirectPath(trimmed.slice(base.length) || '/');
+    }
+    return normalizeRedirectPath(trimmed);
+}
+/** Count redirect chains and loops from stored redirect rules. */
+export async function gatherRedirectSignals(db) {
+    if (!db?.redirect?.findMany)
+        return { redirectChains: 0, redirectLoops: 0 };
+    const rows = await findInBatches(({ take, cursor }) => db.redirect
+        .findMany({
+        take,
+        ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+        orderBy: { id: 'asc' },
+        select: { id: true, source: true, destination: true, enabled: true },
+    })
+        .catch(() => []));
+    const rules = rows.map((r) => ({
+        id: r.id,
+        from: r.source,
+        to: r.destination,
+        enabled: r.enabled,
+    }));
+    const chains = detectChainsAndLoops(rules);
+    return {
+        redirectChains: chains.filter((c) => c.kind === 'chain').length,
+        redirectLoops: chains.filter((c) => c.kind === 'loop').length,
+    };
+}
+/**
+ * Find internal links in content that don't resolve to a known page URL or
+ * redirect terminal. Static analysis only — does not fetch URLs. Callers that
+ * raise "returns 404" issues must pass the result through
+ * {@link confirmBrokenLinksOverHttp}.
+ */
+export function detectBrokenInternalLinks(entities, options = {}) {
+    const siteUrl = (options.siteUrl ?? '').replace(/\/+$/, '');
+    const knownPaths = new Set();
+    for (const e of entities) {
+        if (e.url)
+            knownPaths.add(normalizeRedirectPath(e.url));
+        if (siteUrl && e.url.startsWith('/')) {
+            knownPaths.add(normalizeRedirectPath(`${siteUrl}${e.url}`));
+        }
+    }
+    const edgeMap = buildEdgeMap(options.redirectRules ?? []);
+    const broken = [];
+    const reported = new Set();
+    const pathExists = (path) => {
+        if (knownPaths.has(path))
+            return true;
+        const resolved = resolveChain(edgeMap, path);
+        if (resolved.loop)
+            return false;
+        return knownPaths.has(resolved.terminal);
+    };
+    for (const e of entities) {
+        const content = e.content ?? '';
+        if (!content)
+            continue;
+        let match;
+        HREF_REGEX.lastIndex = 0;
+        while ((match = HREF_REGEX.exec(content)) !== null) {
+            const href = match[1];
+            if (!href)
+                continue;
+            const path = normalizePath(href, siteUrl);
+            if (!path || pathExists(path))
+                continue;
+            const key = `${e.entityId}:${path}`;
+            if (reported.has(key))
+                continue;
+            reported.add(key);
+            broken.push({
+                url: href,
+                fromEntityId: e.entityId,
+                fromTitle: e.title,
+                fromUrl: e.url,
+            });
+        }
+    }
+    return broken;
+}
+/** Load redirect rules and gather all audit cross-cutting signals. */
+export async function gatherAuditSignals(db, entities, siteUrl) {
+    const redirectPart = await gatherRedirectSignals(db);
+    let redirectRules = [];
+    if (db?.redirect?.findMany) {
+        const rows = await findInBatches(({ take, cursor }) => db.redirect
+            .findMany({
+            take,
+            ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+            orderBy: { id: 'asc' },
+            select: { id: true, source: true, destination: true, enabled: true },
+        })
+            .catch(() => []));
+        redirectRules = rows.map((r) => ({
+            id: r.id,
+            from: r.source,
+            to: r.destination,
+            enabled: r.enabled,
+        }));
+    }
+    const candidates = detectBrokenInternalLinks(entities, { siteUrl, redirectRules });
+    // No site URL → cannot verify live; do not claim "Internal link returns 404".
+    const brokenLinks = siteUrl ? await confirmBrokenLinksOverHttp(candidates ?? [], { siteUrl }) : [];
+    return { ...redirectPart, brokenLinks };
+}
+//# sourceMappingURL=audit-signals.js.map

package/dist/seo/audit-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-signals.js","sourceRoot":"","sources":["../../src/seo/audit-signals.ts"],"names":[],"mappings":"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"}