@actuate-media/cms-core 0.78.0 → 0.79.0

package/dist/__tests__/seo/issue-fix-ai.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { suggestAiFix, pendingFixFromMetadata, pendingFixToMetadata, } from '../../seo/issue-fix-ai.js';
+const generateTextForFeatureMock = vi.fn();
+vi.mock('../../ai/index.js', () => ({
+    generateTextForFeature: (...args) => generateTextForFeatureMock(...args),
+}));
+vi.mock('../../security/audit.js', () => ({
+    logEvent: vi.fn(async () => { }),
+}));
+vi.mock('../../config/runtime.js', () => ({
+    getActuateConfig: () => ({
+        collections: { posts: { seo: { defaultSchemaType: 'BlogPosting' } } },
+    }),
+}));
+const entity = {
+    entityType: 'post',
+    entityId: 'doc-1',
+    title: 'How to Contact Support',
+    url: '/support',
+    content: '<p>Reach our team by email or chat for help with billing and technical issues.</p>',
+    metaTitle: 'Duplicate Title Here',
+    metaDescription: 'Same description on two pages about support.',
+    canonicalUrl: 'https://example.com/support',
+    noindex: false,
+};
+const ctx = {
+    entity,
+    siteSeo: { siteName: 'Example', siteUrl: 'https://example.com' },
+    updatedAt: '2024-06-27T10:00:00.000Z',
+};
+const deps = { db: {}, userId: 'user-1', collection: 'posts' };
+describe('suggestAiFix', () => {
+    beforeEach(() => {
+        generateTextForFeatureMock.mockReset();
+    });
+    it('generates a unique meta title for duplicate-meta-title', async () => {
+        generateTextForFeatureMock.mockResolvedValue({
+            ok: true,
+            text: 'Contact UpChat Support — Help & Billing',
+        });
+        const result = await suggestAiFix({ type: 'duplicate-meta-title', title: 'Duplicate', entityType: 'post', entityId: 'doc-1' }, ctx, deps);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.suggestion.autoFixable).toBe(true);
+        expect(result.suggestion.source).toBe('ai');
+        expect(result.suggestion.patch.metaTitle).toBe('Contact UpChat Support — Help & Billing');
+    });
+    it('returns aiUnavailable when provider is not configured', async () => {
+        generateTextForFeatureMock.mockResolvedValue({
+            ok: false,
+            code: 'no_provider',
+            message: 'none',
+        });
+        const result = await suggestAiFix({ type: 'missing-meta-title', title: 'Missing', entityType: 'post', entityId: 'doc-1' }, ctx, deps);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.suggestion.aiUnavailable).toBe(true);
+        expect(result.suggestion.autoFixable).toBe(false);
+    });
+    it('parses JSON-LD for missing-structured-data', async () => {
+        generateTextForFeatureMock.mockResolvedValue({
+            ok: true,
+            text: '{"@type":"BlogPosting","headline":"Support","description":"Help page"}',
+        });
+        const result = await suggestAiFix({
+            type: 'missing-structured-data',
+            title: 'No schema',
+            entityType: 'post',
+            entityId: 'doc-1',
+        }, ctx, deps);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.suggestion.patch.structuredDataType).toBe('BlogPosting');
+        expect(result.suggestion.patch.structuredData).toMatchObject({ '@type': 'BlogPosting' });
+    });
+});
+describe('pendingFix metadata', () => {
+    it('round-trips through metadata helpers', () => {
+        const suggestion = {
+            autoFixable: true,
+            source: 'ai',
+            fingerprint: 'doc-1:1:duplicate-meta-title',
+            patch: { metaTitle: 'Unique Title' },
+            changes: [],
+            justification: 'AI fix',
+        };
+        const meta = pendingFixToMetadata(suggestion);
+        const cached = pendingFixFromMetadata(meta);
+        expect(cached?.fingerprint).toBe(suggestion.fingerprint);
+        expect(cached?.patch).toEqual(suggestion.patch);
+    });
+});
+//# sourceMappingURL=issue-fix-ai.test.js.map

package/dist/__tests__/seo/issue-fix-ai.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-fix-ai.test.js","sourceRoot":"","sources":["../../../src/__tests__/seo/issue-fix-ai.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAE7D,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,2BAA2B,CAAA;AAGlC,MAAM,0BAA0B,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;AAE1C,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,sBAAsB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC;CACpF,CAAC,CAAC,CAAA;AAEH,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;CAChC,CAAC,CAAC,CAAA;AAEH,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;QACvB,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,iBAAiB,EAAE,aAAa,EAAE,EAAE,EAAE;KACtE,CAAC;CACH,CAAC,CAAC,CAAA;AAEH,MAAM,MAAM,GAAqB;IAC/B,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,wBAAwB;IAC/B,GAAG,EAAE,UAAU;IACf,OAAO,EAAE,oFAAoF;IAC7F,SAAS,EAAE,sBAAsB;IACjC,eAAe,EAAE,8CAA8C;IAC/D,YAAY,EAAE,6BAA6B;IAC3C,OAAO,EAAE,KAAK;CACf,CAAA;AAED,MAAM,GAAG,GAAG;IACV,MAAM;IACN,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB,EAAE;IAChE,SAAS,EAAE,0BAA0B;CACtC,CAAA;AAED,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,EAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAEvE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,0BAA0B,CAAC,SAAS,EAAE,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,0BAA0B,CAAC,iBAAiB,CAAC;YAC3C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,yCAAyC;SAChD,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC3F,GAAG,EACH,IAAI,CACL,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAM;QACtB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IAC3F,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,0BAA0B,CAAC,iBAAiB,CAAC;YAC3C,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EACvF,GAAG,EACH,IAAI,CACL,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAM;QACtB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,0BAA0B,CAAC,iBAAiB,CAAC;YAC3C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,wEAAwE;SAC/E,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B;YACE,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,OAAO;SAClB,EACD,GAAG,EACH,IAAI,CACL,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAM;QACtB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACtE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;IAC1F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,UAAU,GAAG;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,IAAa;YACrB,WAAW,EAAE,8BAA8B;YAC3C,KAAK,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE;YACpC,OAAO,EAAE,EAAE;YACX,aAAa,EAAE,QAAQ;SACxB,CAAA;QACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;QACxD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/seo/issue-fix-orchestrator.test.d.ts

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

package/dist/__tests__/seo/issue-fix-orchestrator.test.d.ts.map

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

package/dist/__tests__/seo/issue-fix-orchestrator.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { suggestIssueFix } from '../../seo/issue-fix.js';
+const suggestAiFixMock = vi.fn();
+vi.mock('../../seo/issue-fix-ai.js', () => ({
+    AI_FIX_TYPES: new Set(['duplicate-meta-title', 'missing-structured-data']),
+    suggestAiFix: (...args) => suggestAiFixMock(...args),
+}));
+const entity = {
+    entityType: 'page',
+    entityId: 'doc-1',
+    title: 'About',
+    url: '/about',
+    content: '<p>About us content here with enough words for SEO testing purposes.</p>',
+    metaTitle: 'Shared Title',
+    metaDescription: null,
+    canonicalUrl: 'https://example.com/about',
+    noindex: false,
+};
+describe('suggestIssueFix', () => {
+    beforeEach(() => {
+        suggestAiFixMock.mockReset();
+    });
+    it('returns deterministic fix without calling AI when available', async () => {
+        const result = await suggestIssueFix({ type: 'accidental-noindex', title: 'Noindex', entityType: 'page', entityId: 'doc-1' }, { entity: { ...entity, noindex: true }, updatedAt: '2024-01-01T00:00:00.000Z' });
+        expect(result.cacheForApply).toBe(false);
+        expect(result.suggestion.source).toBe('deterministic');
+        expect(result.suggestion.autoFixable).toBe(true);
+        expect(suggestAiFixMock).not.toHaveBeenCalled();
+    });
+    it('falls back to AI for duplicate-meta-title', async () => {
+        suggestAiFixMock.mockResolvedValue({
+            ok: true,
+            suggestion: {
+                autoFixable: true,
+                source: 'ai',
+                fingerprint: 'doc-1:1:duplicate-meta-title',
+                patch: { metaTitle: 'Unique About Page Title' },
+                changes: [],
+                justification: 'AI title',
+            },
+        });
+        const result = await suggestIssueFix({ type: 'duplicate-meta-title', title: 'Dup', entityType: 'page', entityId: 'doc-1' }, { entity, updatedAt: '2024-01-01T00:00:00.000Z' }, { db: {}, userId: 'u1', collection: 'pages' });
+        expect(suggestAiFixMock).toHaveBeenCalled();
+        expect(result.cacheForApply).toBe(true);
+        expect(result.suggestion.source).toBe('ai');
+    });
+});
+//# sourceMappingURL=issue-fix-orchestrator.test.js.map

package/dist/__tests__/seo/issue-fix-orchestrator.test.js.map

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

package/dist/__tests__/seo/issue-fix.test.d.ts

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

package/dist/__tests__/seo/issue-fix.test.d.ts.map

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

package/dist/__tests__/seo/issue-fix.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from 'vitest';
+import { suggestDeterministicFix, truncateAtWordBoundary, excerptForMetaDescription, buildFixFingerprint, META_TITLE_MAX, META_DESC_MAX, } from '../../seo/issue-fix.js';
+const baseEntity = {
+    entityType: 'page',
+    entityId: 'doc-1',
+    title: 'How to Contact UpChat Support',
+    url: '/support',
+    content: '<p>Reach our team by email or chat. We respond within one business day and offer priority support on paid plans.</p>' +
+        ' '.repeat(50),
+    metaTitle: null,
+    metaDescription: null,
+    canonicalUrl: null,
+    noindex: false,
+};
+const siteSeo = {
+    siteName: 'UpChat',
+    siteUrl: 'https://upchat.example',
+    titleTemplate: '%page% — %site%',
+};
+describe('truncateAtWordBoundary', () => {
+    it('returns short text unchanged', () => {
+        expect(truncateAtWordBoundary('Hello world', 60)).toBe('Hello world');
+    });
+    it('truncates long text at a word boundary', () => {
+        const long = 'word '.repeat(30).trim();
+        const out = truncateAtWordBoundary(long, 40);
+        expect(out.length).toBeLessThanOrEqual(40);
+        expect(out.endsWith('word')).toBe(true);
+    });
+});
+describe('excerptForMetaDescription', () => {
+    it('strips HTML and caps length', () => {
+        const out = excerptForMetaDescription(baseEntity.content ?? '', META_DESC_MAX);
+        expect(out).not.toContain('<');
+        expect(out.length).toBeLessThanOrEqual(META_DESC_MAX);
+        expect(out.length).toBeGreaterThan(20);
+    });
+});
+describe('suggestDeterministicFix', () => {
+    const ctx = { entity: baseEntity, siteSeo, updatedAt: '2024-06-27T10:00:00.000Z' };
+    it('suggests a meta title for missing-meta-title', () => {
+        const s = suggestDeterministicFix({ type: 'missing-meta-title', title: 'Missing', entityId: 'doc-1', entityType: 'page' }, ctx);
+        expect(s.autoFixable).toBe(true);
+        expect(s.patch.metaTitle).toBe('How to Contact UpChat Support — UpChat');
+        expect(s.changes[0]?.field).toBe('metaTitle');
+    });
+    it('truncates an over-long meta title', () => {
+        const longTitle = 'A'.repeat(80);
+        const s = suggestDeterministicFix({ type: 'meta-title-length', title: 'Too long', entityType: 'page', entityId: 'doc-1' }, {
+            ...ctx,
+            entity: { ...baseEntity, metaTitle: longTitle },
+        });
+        expect(s.autoFixable).toBe(true);
+        expect(String(s.patch.metaTitle).length).toBeLessThanOrEqual(META_TITLE_MAX);
+    });
+    it('clears accidental noindex', () => {
+        const s = suggestDeterministicFix({ type: 'accidental-noindex', title: 'Noindex', entityType: 'page', entityId: 'doc-1' }, { ...ctx, entity: { ...baseEntity, noindex: true } });
+        expect(s.autoFixable).toBe(true);
+        expect(s.patch).toEqual({ noindex: false });
+    });
+    it('drafts meta description from content when missing', () => {
+        const s = suggestDeterministicFix({
+            type: 'missing-meta-description',
+            title: 'Missing desc',
+            entityType: 'page',
+            entityId: 'doc-1',
+        }, ctx);
+        expect(s.autoFixable).toBe(true);
+        expect(String(s.patch.metaDescription).length).toBeGreaterThan(0);
+    });
+    it('truncates an over-long meta description', () => {
+        const long = 'x'.repeat(200);
+        const s = suggestDeterministicFix({
+            type: 'meta-description-length',
+            title: 'Long desc',
+            entityType: 'page',
+            entityId: 'doc-1',
+        }, { ...ctx, entity: { ...baseEntity, metaDescription: long } });
+        expect(s.autoFixable).toBe(true);
+        expect(String(s.patch.metaDescription).length).toBeLessThanOrEqual(META_DESC_MAX);
+    });
+    it('sets canonical when site URL is configured', () => {
+        const s = suggestDeterministicFix({ type: 'missing-canonical', title: 'Canonical', entityType: 'page', entityId: 'doc-1' }, ctx);
+        expect(s.autoFixable).toBe(true);
+        expect(s.patch.canonical).toBe('https://upchat.example/support');
+    });
+    it('returns manual-only for unsupported issue types', () => {
+        const s = suggestDeterministicFix({ type: 'thin-content', title: 'Thin', entityType: 'page', entityId: 'doc-1' }, ctx);
+        expect(s.autoFixable).toBe(false);
+        expect(Object.keys(s.patch)).toHaveLength(0);
+    });
+    it('buildFixFingerprint changes when document updates', () => {
+        const a = buildFixFingerprint('doc-1', 'missing-meta-title', '2024-01-01T00:00:00.000Z');
+        const b = buildFixFingerprint('doc-1', 'missing-meta-title', '2024-06-01T00:00:00.000Z');
+        expect(a).not.toBe(b);
+    });
+});
+//# sourceMappingURL=issue-fix.test.js.map

package/dist/__tests__/seo/issue-fix.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-fix.test.js","sourceRoot":"","sources":["../../../src/__tests__/seo/issue-fix.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAA;AAG/B,MAAM,UAAU,GAAqB;IACnC,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,+BAA+B;IACtC,GAAG,EAAE,UAAU;IACf,OAAO,EACL,sHAAsH;QACtH,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IAChB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,IAAI;IAClB,OAAO,EAAE,KAAK;CACf,CAAA;AAED,MAAM,OAAO,GAAG;IACd,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,wBAAwB;IACjC,aAAa,EAAE,iBAAiB;CACjC,CAAA;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,sBAAsB,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACtC,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,yBAAyB,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,aAAa,CAAC,CAAA;QAC9E,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAA;IAElF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,uBAAuB,CAC/B,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,EACvF,GAAG,CACJ,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;QACxE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,uBAAuB,CAC/B,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EACvF;YACE,GAAG,GAAG;YACN,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;SAChD,CACF,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,uBAAuB,CAC/B,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EACvF,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CACrD,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,uBAAuB,CAC/B;YACE,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,OAAO;SAClB,EACD,GAAG,CACJ,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,GAAG,uBAAuB,CAC/B;YACE,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,OAAO;SAClB,EACD,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAC7D,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,uBAAuB,CAC/B,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EACxF,GAAG,CACJ,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,uBAAuB,CAC/B,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC9E,GAAG,CACJ,CAAA;QACD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAG,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,CAAC,CAAA;QACxF,MAAM,CAAC,GAAG,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,CAAC,CAAA;QACxF,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/api/routes/seo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../../src/api/routes/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAsC7C,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7F,MAAM,EAAE,CAAC,EAAE,GACV,CAAC,EAAE,CAQL;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2pCzD"}
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../../src/api/routes/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAwC7C,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7F,MAAM,EAAE,CAAC,EAAE,GACV,CAAC,EAAE,CAQL;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAk9DzD"}