@actuate-media/cms-core 0.28.1 → 0.30.0

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__/middleware.test.d.ts

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

package/dist/__tests__/middleware.test.d.ts.map

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

package/dist/__tests__/middleware.test.js

@@ -0,0 +1,50 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createCMSMiddleware } from '../middleware.js';
+/**
+ * Regression coverage for the admin/API route matching boundary. The guard used
+ * `startsWith('/admin')`, which also captured sibling public routes such as
+ * `/administrators` or `/admin-news`. Those must NOT be treated as admin routes.
+ */
+describe('createCMSMiddleware route boundary', () => {
+    const origSecret = process.env.CMS_SECRET;
+    beforeEach(() => {
+        process.env.CMS_SECRET = 'x'.repeat(32);
+    });
+    afterEach(() => {
+        process.env.CMS_SECRET = origSecret;
+    });
+    function req(path) {
+        return new Request(`https://example.com${path}`);
+    }
+    it('does not treat /admin-news as an admin route (IP allowlist not enforced)', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        // An admin route with a non-allowlisted IP would be 403; a public route
+        // passes through (null). /admin-news must pass through.
+        const res = await mw(req('/admin-news'));
+        expect(res).toBeNull();
+    });
+    it('does not treat /administrators as an admin route', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        expect(await mw(req('/administrators'))).toBeNull();
+    });
+    it('still enforces the allowlist on the exact admin path', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        const res = await mw(req('/admin'));
+        expect(res?.status).toBe(403);
+    });
+    it('still enforces the allowlist on nested admin paths', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        const res = await mw(req('/admin/collections/posts'));
+        expect(res?.status).toBe(403);
+    });
+    it('does not treat /api/cmsx as a CMS API route', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        expect(await mw(req('/api/cmsx/thing'))).toBeNull();
+    });
+    it('enforces the allowlist on /api/cms routes', async () => {
+        const mw = createCMSMiddleware({ admin: { path: '/admin', ipAllowlist: ['10.0.0.1'] } });
+        const res = await mw(req('/api/cms/documents'));
+        expect(res?.status).toBe(403);
+    });
+});
+//# sourceMappingURL=middleware.test.js.map

package/dist/__tests__/middleware.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.test.js","sourceRoot":"","sources":["../../src/__tests__/middleware.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/analysis-markdown.test.d.ts

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

package/dist/__tests__/seo/analysis-markdown.test.d.ts.map

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

package/dist/__tests__/seo/analysis-markdown.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest';
+import { analyzeContent, extractHeadings } from '../../seo/analysis.js';
+import { countH1 } from '../../seo/score.js';
+/**
+ * Regression coverage for markdown-bodied content. The heading checks used to
+ * match only HTML `<h1>`/`<h2>` tags, so every markdown post was wrongly flagged
+ * with "No H1 heading found" and "no subheadings". These tests lock in that both
+ * HTML and Markdown headings are recognised.
+ */
+describe('extractHeadings (markdown-aware)', () => {
+    it('extracts ATX markdown headings at the requested level', () => {
+        const md = '# Title\n\nIntro.\n\n## Section A\n\n## Section B\n';
+        expect(extractHeadings(md, 1)).toEqual(['Title']);
+        expect(extractHeadings(md, 2)).toEqual(['Section A', 'Section B']);
+    });
+    it('extracts Setext markdown headings', () => {
+        const md = 'Big Title\n=========\n\nA Subhead\n---------\n';
+        expect(extractHeadings(md, 1)).toEqual(['Big Title']);
+        expect(extractHeadings(md, 2)).toEqual(['A Subhead']);
+    });
+    it('still extracts HTML headings', () => {
+        const html = '<h1>HTML Title</h1><h2>Sub</h2>';
+        expect(extractHeadings(html, 1)).toEqual(['HTML Title']);
+        expect(extractHeadings(html, 2)).toEqual(['Sub']);
+    });
+    it('ignores `#` inside fenced code blocks', () => {
+        const md = '# Real Title\n\n```\n# not a heading\n```\n';
+        expect(extractHeadings(md, 1)).toEqual(['Real Title']);
+    });
+    it('does not treat a higher-level ATX heading as a lower one', () => {
+        expect(extractHeadings('### Deep', 1)).toEqual([]);
+        expect(extractHeadings('### Deep', 3)).toEqual(['Deep']);
+    });
+});
+describe('countH1 (markdown-aware)', () => {
+    it('counts HTML h1 tags', () => {
+        expect(countH1('<h1>a</h1>')).toBe(1);
+        expect(countH1('<H1>a</H1><h1>b</h1>')).toBe(2);
+    });
+    it('counts markdown h1 headings', () => {
+        expect(countH1('# Only One\n\nbody')).toBe(1);
+        expect(countH1('# One\n\n# Two')).toBe(2);
+        expect(countH1('## Not an h1')).toBe(0);
+    });
+});
+describe('analyzeContent h1-present for markdown bodies', () => {
+    it('passes the H1 check when the markdown body has exactly one H1', () => {
+        const result = analyzeContent({
+            title: 'My Post',
+            slug: 'my-post',
+            content: '# My Post\n\nSome intro text.\n\n## Details\n\nMore text here.',
+        });
+        const h1Check = result.checks.find((c) => c.id === 'h1-present');
+        expect(h1Check?.status).toBe('good');
+    });
+});
+//# sourceMappingURL=analysis-markdown.test.js.map

package/dist/__tests__/seo/analysis-markdown.test.js.map

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

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":""}