@actuate-media/cms-core 0.28.1 → 0.29.0

package/dist/__tests__/media/seo.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seo.test.d.ts.map

package/dist/__tests__/media/seo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/media/seo.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/media/seo.test.js

@@ -0,0 +1,186 @@
+import { describe, expect, it } from 'vitest';
+import { calculateMediaSeoScore, gradeForScore, isGenericFilename, mediaKind, MEDIA_SEO_WEIGHTS, } from '../../media/seo.js';
+describe('media SEO weights', () => {
+    it('sum to 100', () => {
+        const total = Object.values(MEDIA_SEO_WEIGHTS).reduce((a, b) => a + b, 0);
+        expect(total).toBe(100);
+    });
+});
+describe('mediaKind', () => {
+    it.each([
+        ['image/jpeg', 'image'],
+        ['image/png', 'image'],
+        ['image/webp', 'image'],
+        ['image/svg+xml', 'svg'],
+        ['video/mp4', 'video'],
+        ['audio/mpeg', 'audio'],
+        ['application/pdf', 'pdf'],
+        ['application/zip', 'other'],
+        ['', 'other'],
+    ])('maps %s -> %s', (mime, expected) => {
+        expect(mediaKind(mime)).toBe(expected);
+    });
+    it('treats undefined as other', () => {
+        expect(mediaKind(undefined)).toBe('other');
+        expect(mediaKind(null)).toBe('other');
+    });
+});
+describe('isGenericFilename', () => {
+    it.each([
+        'IMG_4892.jpg',
+        'img4892.png',
+        'DSC_0001.jpg',
+        'DSCF1234.jpg',
+        'P1010101.jpg',
+        'image.png',
+        'image1.png',
+        'photo-2.jpg',
+        'Untitled.png',
+        'Screen Shot 2024-01-01 at 10.00.00.png',
+        'screenshot.png',
+        'download.pdf',
+        '12345.jpg',
+        'a1b2c3d4e5f6.jpg',
+        '',
+        '   ',
+    ])('flags %s as generic', (name) => {
+        expect(isGenericFilename(name)).toBe(true);
+    });
+    it.each([
+        'hero-banner.jpg',
+        'team-photo.png',
+        'product-screenshot.webp',
+        'logo-dark.svg',
+        'annual-report-2025.pdf',
+        'case-study-fintech.pdf',
+    ])('accepts %s as descriptive', (name) => {
+        expect(isGenericFilename(name)).toBe(false);
+    });
+    it('treats null/undefined as generic', () => {
+        expect(isGenericFilename(null)).toBe(true);
+        expect(isGenericFilename(undefined)).toBe(true);
+    });
+});
+describe('gradeForScore', () => {
+    it.each([
+        [100, 'good'],
+        [80, 'good'],
+        [79, 'needs-work'],
+        [60, 'needs-work'],
+        [59, 'poor'],
+        [1, 'poor'],
+        [0, 'critical'],
+    ])('score %d -> %s', (score, grade) => {
+        expect(gradeForScore(score)).toBe(grade);
+    });
+});
+describe('calculateMediaSeoScore', () => {
+    it('awards a perfect 100 when every field is set and the name is descriptive', () => {
+        const input = {
+            fileName: 'product-screenshot.webp',
+            mimeType: 'image/webp',
+            altText: 'A product dashboard screenshot',
+            title: 'Product Dashboard',
+            caption: 'The analytics view',
+            description: 'A detailed look at the analytics dashboard',
+            focusKeyword: 'product dashboard',
+        };
+        const result = calculateMediaSeoScore(input);
+        expect(result.score).toBe(100);
+        expect(result.grade).toBe('good');
+        expect(result.issues).toHaveLength(0);
+    });
+    it('scores hero-banner.jpg at 80 (alt+title+caption+filename+focus, no description)', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'hero-banner.jpg',
+            mimeType: 'image/jpeg',
+            altText: 'Actuate Media team collaborating in a modern open office space',
+            title: 'Actuate Media Hero Banner',
+            caption: 'Our talented team at work',
+            description: '',
+            focusKeyword: 'actuate media',
+        });
+        expect(result.score).toBe(MEDIA_SEO_WEIGHTS.altText +
+            MEDIA_SEO_WEIGHTS.title +
+            MEDIA_SEO_WEIGHTS.caption +
+            MEDIA_SEO_WEIGHTS.descriptiveFileName +
+            MEDIA_SEO_WEIGHTS.focusKeyword);
+        expect(result.score).toBe(80);
+        expect(result.grade).toBe('good');
+        expect(result.issues.map((i) => i.type)).toContain('missing-description');
+        expect(result.issues.map((i) => i.type)).not.toContain('missing-alt');
+    });
+    it('scores a bare generic image at 0 / critical with the expected issues', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'IMG_4892.jpg',
+            mimeType: 'image/jpeg',
+        });
+        expect(result.score).toBe(0);
+        expect(result.grade).toBe('critical');
+        const types = result.issues.map((i) => i.type);
+        expect(types).toContain('missing-alt');
+        expect(types).toContain('missing-title');
+        expect(types).toContain('missing-description');
+        expect(types).toContain('generic-filename');
+        expect(types).toContain('critical-score');
+    });
+    it('does not raise missing-alt for non-visual assets like PDFs', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'annual-report-2025.pdf',
+            mimeType: 'application/pdf',
+            title: 'Annual Report 2025',
+            description: 'Our full-year results',
+        });
+        const types = result.issues.map((i) => i.type);
+        expect(types).not.toContain('missing-alt');
+    });
+    it('flags oversized images above the configured threshold', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'team-photo.png',
+            mimeType: 'image/png',
+            sizeBytes: 4 * 1024 * 1024,
+        }, { maxImageBytes: 2 * 1024 * 1024 });
+        expect(result.issues.map((i) => i.type)).toContain('oversized-image');
+    });
+    it('does not flag oversized for a small image', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'bg-gradient.png',
+            mimeType: 'image/png',
+            sizeBytes: 45 * 1024,
+        });
+        expect(result.issues.map((i) => i.type)).not.toContain('oversized-image');
+    });
+    it('flags missing video caption', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'product-demo.mp4',
+            mimeType: 'video/mp4',
+            title: 'Product Demo',
+        });
+        expect(result.issues.map((i) => i.type)).toContain('missing-video-caption');
+    });
+    it('clamps and rounds the score into 0..100', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'x.jpg',
+            mimeType: 'image/jpeg',
+            altText: 'a',
+            title: 't',
+            description: 'd',
+            caption: 'c',
+            focusKeyword: 'k',
+        });
+        expect(result.score).toBeGreaterThanOrEqual(0);
+        expect(result.score).toBeLessThanOrEqual(100);
+        expect(Number.isInteger(result.score)).toBe(true);
+    });
+    it('treats whitespace-only metadata as missing', () => {
+        const result = calculateMediaSeoScore({
+            fileName: 'hero-banner.jpg',
+            mimeType: 'image/jpeg',
+            altText: '   ',
+            title: '\n\t',
+        });
+        expect(result.issues.map((i) => i.type)).toContain('missing-alt');
+        expect(result.issues.map((i) => i.type)).toContain('missing-title');
+    });
+});
+//# sourceMappingURL=seo.test.js.map

package/dist/__tests__/media/seo.test.js.map

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

package/dist/__tests__/redirects/graph.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph.test.d.ts.map

package/dist/__tests__/redirects/graph.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/redirects/graph.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/redirects/graph.test.js

@@ -0,0 +1,104 @@
+import { describe, it, expect } from 'vitest';
+import { normalizeRedirectPath, isExternal, resolveChain, buildEdgeMap, detectChainsAndLoops, wouldCreateLoop, isRedirectStale, } from '../../redirects/graph.js';
+describe('normalizeRedirectPath', () => {
+    it('ensures a leading slash and strips trailing slash', () => {
+        expect(normalizeRedirectPath('about')).toBe('/about');
+        expect(normalizeRedirectPath('/about/')).toBe('/about');
+        expect(normalizeRedirectPath('/')).toBe('/');
+    });
+    it('strips query and hash and lowercases', () => {
+        expect(normalizeRedirectPath('/About?x=1#h')).toBe('/about');
+    });
+    it('leaves external URLs intact (lowercased)', () => {
+        expect(normalizeRedirectPath('https://Example.com/Path')).toBe('https://example.com/path');
+    });
+});
+describe('isExternal', () => {
+    it('detects absolute URLs', () => {
+        expect(isExternal('https://x.com')).toBe(true);
+        expect(isExternal('/internal')).toBe(false);
+    });
+});
+describe('resolveChain', () => {
+    const rules = [
+        { id: '1', from: '/a', to: '/b' },
+        { id: '2', from: '/b', to: '/c' },
+        { id: '3', from: '/c', to: '/d' },
+    ];
+    it('follows the chain to the terminal', () => {
+        const map = buildEdgeMap(rules);
+        const res = resolveChain(map, '/a');
+        expect(res.loop).toBe(false);
+        expect(res.terminal).toBe('/d');
+        expect(res.hops).toEqual(['/a', '/b', '/c', '/d']);
+    });
+    it('detects loops', () => {
+        const map = buildEdgeMap([
+            { id: '1', from: '/a', to: '/b' },
+            { id: '2', from: '/b', to: '/a' },
+        ]);
+        const res = resolveChain(map, '/a');
+        expect(res.loop).toBe(true);
+    });
+});
+describe('detectChainsAndLoops', () => {
+    it('detects a multi-hop chain', () => {
+        const chains = detectChainsAndLoops([
+            { id: '1', from: '/a', to: '/b' },
+            { id: '2', from: '/b', to: '/c' },
+        ]);
+        const chain = chains.find((c) => c.kind === 'chain');
+        expect(chain).toBeTruthy();
+        expect(chain.suggestedFrom).toBe('/a');
+        expect(chain.suggestedTo).toBe('/c');
+    });
+    it('detects a loop', () => {
+        const chains = detectChainsAndLoops([
+            { id: '1', from: '/a', to: '/b' },
+            { id: '2', from: '/b', to: '/a' },
+        ]);
+        expect(chains.some((c) => c.kind === 'loop')).toBe(true);
+    });
+    it('ignores a single-hop redirect', () => {
+        const chains = detectChainsAndLoops([{ id: '1', from: '/a', to: '/b' }]);
+        expect(chains).toHaveLength(0);
+    });
+    it('ignores disabled rules', () => {
+        const chains = detectChainsAndLoops([
+            { id: '1', from: '/a', to: '/b' },
+            { id: '2', from: '/b', to: '/c', enabled: false },
+        ]);
+        expect(chains).toHaveLength(0);
+    });
+});
+describe('wouldCreateLoop', () => {
+    const rules = [{ id: '1', from: '/b', to: '/a' }];
+    it('flags a direct loop', () => {
+        expect(wouldCreateLoop(rules, '/a', '/b')).toBe(true);
+    });
+    it('flags a self-redirect', () => {
+        expect(wouldCreateLoop(rules, '/x', '/x')).toBe(true);
+    });
+    it('allows a safe redirect', () => {
+        expect(wouldCreateLoop(rules, '/a', '/c')).toBe(false);
+    });
+    it('allows external targets', () => {
+        expect(wouldCreateLoop(rules, '/a', 'https://x.com')).toBe(false);
+    });
+    it('ignores the rule being edited', () => {
+        expect(wouldCreateLoop(rules, '/b', '/a', '1')).toBe(false);
+    });
+});
+describe('isRedirectStale', () => {
+    it('treats never-hit as stale', () => {
+        expect(isRedirectStale(null)).toBe(true);
+    });
+    it('treats a recent hit as not stale', () => {
+        expect(isRedirectStale(new Date())).toBe(false);
+    });
+    it('treats an old hit as stale', () => {
+        const old = new Date(Date.now() - 90 * 24 * 60 * 60 * 1000);
+        expect(isRedirectStale(old)).toBe(true);
+    });
+});
+//# sourceMappingURL=graph.test.js.map

package/dist/__tests__/redirects/graph.test.js.map

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

package/dist/__tests__/redirects/suggest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suggest.test.d.ts.map

package/dist/__tests__/redirects/suggest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/redirects/suggest.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/redirects/suggest.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect } from 'vitest';
+import { suggestRedirectTarget } from '../../redirects/suggest.js';
+describe('suggestRedirectTarget', () => {
+    const candidates = [
+        { url: '/services/enterprise-plans', title: 'Enterprise Plans' },
+        { url: '/about', title: 'About Us' },
+        { url: '/blog/launch', title: 'Launch announcement' },
+    ];
+    it('matches a dead path to the most similar live URL', () => {
+        const result = suggestRedirectTarget('/services/enterprise', candidates);
+        expect(result).not.toBeNull();
+        expect(result.toPath).toBe('/services/enterprise-plans');
+        expect(result.confidence).toBeGreaterThan(30);
+    });
+    it('returns null when nothing clears the threshold', () => {
+        const result = suggestRedirectTarget('/zzz-nothing-related', candidates, 40);
+        expect(result).toBeNull();
+    });
+    it('returns null with no candidates', () => {
+        expect(suggestRedirectTarget('/x', [])).toBeNull();
+    });
+    it('uses title similarity when path tokens are weak', () => {
+        const result = suggestRedirectTarget('/launch-announcement', candidates);
+        expect(result).not.toBeNull();
+        expect(result.toPath).toBe('/blog/launch');
+    });
+});
+//# sourceMappingURL=suggest.test.js.map

package/dist/__tests__/redirects/suggest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.test.js","sourceRoot":"","sources":["../../../src/__tests__/redirects/suggest.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,MAAM,UAAU,GAAG;QACjB,EAAE,GAAG,EAAE,4BAA4B,EAAE,KAAK,EAAE,kBAAkB,EAAE;QAChE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE;QACpC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,qBAAqB,EAAE;KACtD,CAAA;IAED,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAA;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;QACzD,MAAM,CAAC,MAAO,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QAC5E,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,MAAM,GAAG,qBAAqB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAA;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/seo/audit-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-engine.test.d.ts.map

package/dist/__tests__/seo/audit-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-engine.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/seo/audit-engine.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/seo/audit-engine.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect } from 'vitest';
+import { runSeoAuditAnalysis, buildQuickWins, issueKeyFor, } from '../../seo/audit-engine.js';
+const goodPage = {
+    entityType: 'page',
+    entityId: 'p1',
+    title: 'Home',
+    url: '/',
+    content: '<h1>Home</h1>' + 'word '.repeat(400),
+    metaTitle: 'Home — Acme, the modern CMS for teams',
+    metaDescription: 'Acme is the modern content platform that helps marketing and engineering teams ship reliable, fast, search-optimised websites together without friction every week.',
+    focusKeyword: 'modern cms',
+    canonicalUrl: 'https://acme.com/',
+    ogTitle: 'Home',
+    ogDescription: 'Welcome',
+    ogImage: 'https://acme.com/og.png',
+    structuredDataType: 'WebPage',
+    noindex: false,
+};
+function findIssues(issues, type) {
+    return issues.filter((i) => i.type === type);
+}
+describe('runSeoAuditAnalysis', () => {
+    it('produces no content issues for a fully-optimised page', () => {
+        const result = runSeoAuditAnalysis([goodPage]);
+        expect(result.pages).toHaveLength(1);
+        expect(result.pages[0].score).toBeGreaterThanOrEqual(95);
+        expect(result.counts.total).toBe(0);
+    });
+    it('detects missing meta description', () => {
+        const result = runSeoAuditAnalysis([{ ...goodPage, metaDescription: '' }]);
+        const found = findIssues(result.issues, 'missing-meta-description');
+        expect(found).toHaveLength(1);
+        expect(found[0].severity).toBe('warning');
+        expect(found[0].fixActionType).toBe('edit-metadata');
+    });
+    it('detects duplicate meta titles across pages', () => {
+        const a = { ...goodPage, entityId: 'a', url: '/about', metaTitle: 'Same Title Here For Both' };
+        const b = {
+            ...goodPage,
+            entityId: 'b',
+            url: '/services',
+            metaTitle: 'Same Title Here For Both',
+        };
+        const result = runSeoAuditAnalysis([a, b]);
+        const dup = findIssues(result.issues, 'duplicate-meta-title');
+        expect(dup).toHaveLength(1);
+        expect(dup[0].severity).toBe('critical');
+        expect(dup[0].relatedEntityIds.sort()).toEqual(['a', 'b']);
+    });
+    it('does not flag duplicate when titles differ', () => {
+        const a = { ...goodPage, entityId: 'a', metaTitle: 'Title A unique enough here' };
+        const b = { ...goodPage, entityId: 'b', metaTitle: 'Title B unique enough here' };
+        const result = runSeoAuditAnalysis([a, b]);
+        expect(findIssues(result.issues, 'duplicate-meta-title')).toHaveLength(0);
+    });
+    it('detects broken internal links from signals', () => {
+        const result = runSeoAuditAnalysis([goodPage], {
+            brokenLinks: [
+                { url: '/services/enterprise', fromEntityId: 'p1', fromTitle: 'Home', fromUrl: '/' },
+            ],
+        });
+        const broken = findIssues(result.issues, 'broken-internal-link');
+        expect(broken).toHaveLength(1);
+        expect(broken[0].severity).toBe('critical');
+        expect(broken[0].category).toBe('technical');
+    });
+    it('detects missing H1 only in non-empty content', () => {
+        const noH1 = { ...goodPage, content: '<p>no heading here</p>' };
+        const result = runSeoAuditAnalysis([noH1]);
+        expect(findIssues(result.issues, 'missing-h1')).toHaveLength(1);
+    });
+    it('detects thin content', () => {
+        const thin = { ...goodPage, content: '<h1>x</h1> short body', wordCount: 20 };
+        const result = runSeoAuditAnalysis([thin]);
+        expect(findIssues(result.issues, 'thin-content')).toHaveLength(1);
+    });
+    it('detects missing alt text on images', () => {
+        const withImg = { ...goodPage, content: '<h1>x</h1>' + 'w '.repeat(400) + '<img src="a.png">' };
+        const result = runSeoAuditAnalysis([withImg]);
+        expect(findIssues(result.issues, 'missing-alt-text')).toHaveLength(1);
+    });
+    it('counts issues by severity', () => {
+        const bad = {
+            entityType: 'page',
+            entityId: 'bad',
+            title: 'Bad',
+            url: '/bad',
+            content: '<p>thin</p>',
+            metaTitle: '',
+            metaDescription: '',
+        };
+        const result = runSeoAuditAnalysis([bad]);
+        expect(result.counts.total).toBeGreaterThan(0);
+        expect(result.counts.warning).toBeGreaterThanOrEqual(2); // missing title + desc
+    });
+    it('computes a site score that drops with missing metadata', () => {
+        const great = runSeoAuditAnalysis([goodPage]).siteScore.score;
+        const poor = runSeoAuditAnalysis([
+            {
+                ...goodPage,
+                metaTitle: '',
+                metaDescription: '',
+                structuredDataType: '',
+                ogImage: '',
+                canonicalUrl: '',
+            },
+        ]).siteScore.score;
+        expect(great).toBeGreaterThan(poor);
+    });
+});
+describe('issueKeyFor', () => {
+    it('builds a stable key', () => {
+        expect(issueKeyFor('missing-meta-title', 'p1')).toBe('missing-meta-title:p1');
+    });
+});
+describe('buildQuickWins', () => {
+    const mk = (type, impact, id) => ({
+        issueKey: `${type}:${id}`,
+        entityType: 'page',
+        entityId: id,
+        entityTitle: id,
+        url: `/${id}`,
+        severity: 'warning',
+        category: 'content',
+        type,
+        title: type,
+        description: '',
+        impact,
+        recommendation: '',
+        fixable: true,
+        fixActionType: 'edit-metadata',
+        relatedEntityIds: [],
+    });
+    it('ranks higher-impact wins first', () => {
+        const wins = buildQuickWins([
+            mk('missing-canonical', 'Low', '1'),
+            mk('missing-meta-description', 'High', '2'),
+            mk('missing-meta-description', 'High', '3'),
+        ]);
+        expect(wins[0].issueType).toBe('missing-meta-description');
+        expect(wins[0].count).toBe(2);
+    });
+    it('excludes non-fixable issues', () => {
+        const issue = { ...mk('thin-content', 'Low', '1'), fixable: false };
+        expect(buildQuickWins([issue])).toHaveLength(0);
+    });
+    it('caps at 5 wins', () => {
+        const issues = Array.from({ length: 10 }, (_, i) => mk(`type-${i}`, 'Medium', String(i)));
+        expect(buildQuickWins(issues).length).toBeLessThanOrEqual(5);
+    });
+});
+//# sourceMappingURL=audit-engine.test.js.map

package/dist/__tests__/seo/audit-engine.test.js.map

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