@heyseo/mcp-server 0.1.0

package/dist/prompts/index.js

@@ -0,0 +1,267 @@
+/**
+ * MCP Prompt Templates
+ * Pre-built prompts for common SEO analysis tasks
+ */
+export const promptTemplates = [
+    {
+        name: 'seo_audit',
+        description: 'Perform a comprehensive SEO audit for a site, analyzing performance, keywords, pages, and technical factors.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to audit',
+                required: true,
+            },
+            {
+                name: 'focus',
+                description: 'Optional focus area: "technical", "content", "keywords", or "all" (default)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'weekly_report',
+        description: 'Generate a weekly SEO performance report with comparisons to the previous week.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to report on',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'keyword_research',
+        description: 'Analyze current keyword performance and identify opportunities for improvement.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to analyze',
+                required: true,
+            },
+            {
+                name: 'targetKeyword',
+                description: 'Optional specific keyword to research',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'content_optimization',
+        description: 'Get recommendations for optimizing a specific page or content piece for better SEO.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site',
+                required: true,
+            },
+            {
+                name: 'pageUrl',
+                description: 'The URL or path of the page to optimize',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'technical_health_check',
+        description: 'Run a technical SEO health check including Core Web Vitals and performance analysis.',
+        arguments: [
+            {
+                name: 'url',
+                description: 'The URL to analyze',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'traffic_analysis',
+        description: 'Analyze traffic patterns, sources, and user engagement for a site.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to analyze',
+                required: true,
+            },
+            {
+                name: 'period',
+                description: 'Time period: "7d", "28d", "90d" (default: 28d)',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'quick_wins',
+        description: 'Identify quick-win SEO opportunities that can be implemented with minimal effort.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to analyze',
+                required: true,
+            },
+        ],
+    },
+    {
+        name: 'ranking_changes',
+        description: 'Analyze recent ranking changes and identify keywords that gained or lost positions.',
+        arguments: [
+            {
+                name: 'siteId',
+                description: 'The ID of the site to analyze',
+                required: true,
+            },
+            {
+                name: 'threshold',
+                description: 'Minimum position change to report (default: 3)',
+                required: false,
+            },
+        ],
+    },
+];
+/**
+ * Generate prompt messages for a template
+ */
+export function generatePromptMessages(templateName, args) {
+    switch (templateName) {
+        case 'seo_audit':
+            return [
+                {
+                    role: 'user',
+                    content: `Please perform a comprehensive SEO audit for site ${args.siteId}.
+
+${args.focus && args.focus !== 'all' ? `Focus specifically on ${args.focus} aspects.` : 'Cover all aspects: technical, content, keywords, and performance.'}
+
+Include:
+1. Current performance metrics (clicks, impressions, CTR, position)
+2. Top performing and underperforming keywords
+3. Page performance analysis
+4. Technical health (if applicable)
+5. Specific recommendations with priority levels
+6. Create tasks for the top 3-5 action items`,
+                },
+            ];
+        case 'weekly_report':
+            return [
+                {
+                    role: 'user',
+                    content: `Generate a weekly SEO performance report for site ${args.siteId}.
+
+Compare this week's performance to last week and include:
+1. Executive summary with key metrics
+2. Week-over-week changes (clicks, impressions, CTR, position)
+3. Top gaining keywords (improved rankings)
+4. Top losing keywords (declined rankings)
+5. Notable achievements or concerns
+6. Recommended actions for next week`,
+                },
+            ];
+        case 'keyword_research':
+            return [
+                {
+                    role: 'user',
+                    content: `Analyze keyword performance for site ${args.siteId}${args.targetKeyword ? ` with focus on "${args.targetKeyword}"` : ''}.
+
+Include:
+1. Current top performing keywords
+2. Keywords with high impressions but low CTR (opportunities)
+3. Keywords ranking on page 2 that could reach page 1
+4. Related keyword opportunities
+5. Content recommendations for target keywords
+6. Priority ranking of keywords to focus on`,
+                },
+            ];
+        case 'content_optimization':
+            return [
+                {
+                    role: 'user',
+                    content: `Provide content optimization recommendations for the page at ${args.pageUrl} on site ${args.siteId}.
+
+Analyze:
+1. Current search performance for this page
+2. Keywords this page ranks for
+3. CTR performance and opportunities
+4. Technical factors (if URL provided, run PageSpeed analysis)
+5. Content improvement suggestions
+6. Internal linking opportunities
+7. Create actionable tasks for optimization`,
+                },
+            ];
+        case 'technical_health_check':
+            return [
+                {
+                    role: 'user',
+                    content: `Run a technical SEO health check for ${args.url}.
+
+Analyze:
+1. Core Web Vitals (LCP, INP, CLS)
+2. Performance score and factors
+3. Loading performance (FCP, TTFB)
+4. Top optimization opportunities
+5. Mobile vs desktop comparison (if helpful)
+6. Priority fixes with estimated impact
+7. Create tasks for critical issues`,
+                },
+            ];
+        case 'traffic_analysis':
+            return [
+                {
+                    role: 'user',
+                    content: `Analyze traffic patterns for site ${args.siteId} over the last ${args.period || '28d'}.
+
+Include:
+1. Overall traffic metrics (sessions, users, engagement)
+2. Traffic source breakdown (organic, direct, referral, social)
+3. Top landing pages and their performance
+4. Device category breakdown
+5. Engagement metrics (bounce rate, session duration)
+6. Trends and patterns observed
+7. Recommendations for traffic growth`,
+                },
+            ];
+        case 'quick_wins':
+            return [
+                {
+                    role: 'user',
+                    content: `Find quick-win SEO opportunities for site ${args.siteId}.
+
+Look for:
+1. Low-hanging fruit keywords (good position, low CTR)
+2. Pages almost ranking on page 1
+3. High-impression, low-click pages
+4. Simple technical fixes
+5. Quick content improvements
+
+For each opportunity:
+- Explain why it's a quick win
+- Estimate potential impact
+- Provide specific action steps
+- Create a task if appropriate
+
+Focus on changes that can be implemented within a day and show results within weeks.`,
+                },
+            ];
+        case 'ranking_changes':
+            return [
+                {
+                    role: 'user',
+                    content: `Analyze recent ranking changes for site ${args.siteId}.
+
+Compare the last 7 days to the previous 7 days and identify:
+1. Keywords that improved by ${args.threshold || '3'}+ positions
+2. Keywords that declined by ${args.threshold || '3'}+ positions
+3. New keywords ranking in top 20
+4. Keywords that fell out of top 20
+5. Possible causes for significant changes
+6. Recommended actions to address declines
+7. Opportunities to capitalize on improvements`,
+                },
+            ];
+        default:
+            return [
+                {
+                    role: 'user',
+                    content: `Run the ${templateName} analysis with the provided parameters.`,
+                },
+            ];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MCP Resources
+ * Exposes HeySeo data as readable resources
+ */
+import type { HeySeoApiClient } from '../utils/api-client.js';
+/**
+ * Resource template definitions
+ */
+export declare const resourceTemplates: {
+    uriTemplate: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+/**
+ * Parse resource URI to extract type and parameters
+ */
+export declare function parseResourceUri(uri: string): {
+    type: 'sites' | 'site' | 'overview' | 'keywords' | 'pages';
+    siteId?: string;
+} | null;
+/**
+ * Fetch resource content
+ */
+export declare function fetchResource(client: HeySeoApiClient, uri: string): Promise<{
+    content: string;
+    mimeType: string;
+}>;
+/**
+ * List available resources for a client
+ */
+export declare function listResources(client: HeySeoApiClient): Promise<Array<{
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;GA+B7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CA+BP;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0JhD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAsDtF"}

package/dist/resources/index.js

@@ -0,0 +1,247 @@
+/**
+ * MCP Resources
+ * Exposes HeySeo data as readable resources
+ */
+/**
+ * Resource template definitions
+ */
+export const resourceTemplates = [
+    {
+        uriTemplate: 'heyseo://sites',
+        name: 'Connected Sites',
+        description: 'List all sites connected to your HeySeo account',
+        mimeType: 'application/json',
+    },
+    {
+        uriTemplate: 'heyseo://sites/{siteId}',
+        name: 'Site Details',
+        description: 'Get details for a specific connected site',
+        mimeType: 'application/json',
+    },
+    {
+        uriTemplate: 'heyseo://sites/{siteId}/overview',
+        name: 'Site Overview',
+        description: 'Get current SEO metrics overview for a site (last 28 days)',
+        mimeType: 'application/json',
+    },
+    {
+        uriTemplate: 'heyseo://sites/{siteId}/keywords',
+        name: 'Top Keywords',
+        description: 'Get top 50 keywords for a site',
+        mimeType: 'application/json',
+    },
+    {
+        uriTemplate: 'heyseo://sites/{siteId}/pages',
+        name: 'Top Pages',
+        description: 'Get top 50 pages for a site',
+        mimeType: 'application/json',
+    },
+];
+/**
+ * Parse resource URI to extract type and parameters
+ */
+export function parseResourceUri(uri) {
+    // heyseo://sites
+    if (uri === 'heyseo://sites') {
+        return { type: 'sites' };
+    }
+    // heyseo://sites/{siteId}
+    const siteMatch = uri.match(/^heyseo:\/\/sites\/([^/]+)$/);
+    if (siteMatch) {
+        return { type: 'site', siteId: siteMatch[1] };
+    }
+    // heyseo://sites/{siteId}/overview
+    const overviewMatch = uri.match(/^heyseo:\/\/sites\/([^/]+)\/overview$/);
+    if (overviewMatch) {
+        return { type: 'overview', siteId: overviewMatch[1] };
+    }
+    // heyseo://sites/{siteId}/keywords
+    const keywordsMatch = uri.match(/^heyseo:\/\/sites\/([^/]+)\/keywords$/);
+    if (keywordsMatch) {
+        return { type: 'keywords', siteId: keywordsMatch[1] };
+    }
+    // heyseo://sites/{siteId}/pages
+    const pagesMatch = uri.match(/^heyseo:\/\/sites\/([^/]+)\/pages$/);
+    if (pagesMatch) {
+        return { type: 'pages', siteId: pagesMatch[1] };
+    }
+    return null;
+}
+/**
+ * Fetch resource content
+ */
+export async function fetchResource(client, uri) {
+    const parsed = parseResourceUri(uri);
+    if (!parsed) {
+        throw new Error(`Invalid resource URI: ${uri}`);
+    }
+    const endDate = new Date().toISOString().split('T')[0];
+    const startDate = new Date(Date.now() - 28 * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
+    switch (parsed.type) {
+        case 'sites': {
+            const sites = await client.getSites();
+            return {
+                content: JSON.stringify({
+                    totalSites: sites.length,
+                    sites: sites.map((s) => ({
+                        id: s.id,
+                        url: s.url,
+                        name: s.name,
+                        gscConnected: s.gscConnected,
+                        ga4Connected: s.ga4Connected,
+                    })),
+                }, null, 2),
+                mimeType: 'application/json',
+            };
+        }
+        case 'site': {
+            if (!parsed.siteId)
+                throw new Error('Site ID required');
+            const site = await client.getSite(parsed.siteId);
+            return {
+                content: JSON.stringify({
+                    id: site.id,
+                    url: site.url,
+                    name: site.name,
+                    gscConnected: site.gscConnected,
+                    ga4Connected: site.ga4Connected,
+                    ga4PropertyId: site.ga4PropertyId,
+                }, null, 2),
+                mimeType: 'application/json',
+            };
+        }
+        case 'overview': {
+            if (!parsed.siteId)
+                throw new Error('Site ID required');
+            const overview = await client.getSiteOverview(parsed.siteId, { startDate, endDate });
+            const gscMetrics = overview.gsc.rows[0] || {
+                clicks: 0,
+                impressions: 0,
+                ctr: 0,
+                position: 0,
+            };
+            const ga4Metrics = overview.ga4[0]?.metrics || {};
+            return {
+                content: JSON.stringify({
+                    period: { startDate, endDate },
+                    gsc: {
+                        clicks: gscMetrics.clicks,
+                        impressions: gscMetrics.impressions,
+                        ctr: `${(gscMetrics.ctr * 100).toFixed(2)}%`,
+                        avgPosition: gscMetrics.position.toFixed(1),
+                    },
+                    ga4: {
+                        sessions: ga4Metrics.sessions || 0,
+                        activeUsers: ga4Metrics.activeUsers || 0,
+                        newUsers: ga4Metrics.newUsers || 0,
+                        bounceRate: ga4Metrics.bounceRate
+                            ? `${(ga4Metrics.bounceRate * 100).toFixed(1)}%`
+                            : 'N/A',
+                        engagementRate: ga4Metrics.engagementRate
+                            ? `${(ga4Metrics.engagementRate * 100).toFixed(1)}%`
+                            : 'N/A',
+                    },
+                }, null, 2),
+                mimeType: 'application/json',
+            };
+        }
+        case 'keywords': {
+            if (!parsed.siteId)
+                throw new Error('Site ID required');
+            const keywords = await client.getTopKeywords(parsed.siteId, {
+                startDate,
+                endDate,
+                limit: 50,
+            });
+            return {
+                content: JSON.stringify({
+                    period: { startDate, endDate },
+                    totalKeywords: keywords.rows.length,
+                    keywords: keywords.rows.map((row, i) => ({
+                        rank: i + 1,
+                        keyword: row.keys[0],
+                        clicks: row.clicks,
+                        impressions: row.impressions,
+                        ctr: `${(row.ctr * 100).toFixed(2)}%`,
+                        position: row.position.toFixed(1),
+                    })),
+                }, null, 2),
+                mimeType: 'application/json',
+            };
+        }
+        case 'pages': {
+            if (!parsed.siteId)
+                throw new Error('Site ID required');
+            const pages = await client.getTopPages(parsed.siteId, {
+                startDate,
+                endDate,
+                limit: 50,
+            });
+            return {
+                content: JSON.stringify({
+                    period: { startDate, endDate },
+                    totalPages: pages.rows.length,
+                    pages: pages.rows.map((row, i) => ({
+                        rank: i + 1,
+                        page: row.keys[0],
+                        clicks: row.clicks,
+                        impressions: row.impressions,
+                        ctr: `${(row.ctr * 100).toFixed(2)}%`,
+                        position: row.position.toFixed(1),
+                    })),
+                }, null, 2),
+                mimeType: 'application/json',
+            };
+        }
+        default:
+            throw new Error(`Unknown resource type: ${parsed.type}`);
+    }
+}
+/**
+ * List available resources for a client
+ */
+export async function listResources(client) {
+    const resources = [];
+    // Always include sites list
+    resources.push({
+        uri: 'heyseo://sites',
+        name: 'Connected Sites',
+        description: 'List all sites connected to your HeySeo account',
+        mimeType: 'application/json',
+    });
+    // Fetch sites and add resources for each
+    try {
+        const sites = await client.getSites();
+        for (const site of sites) {
+            resources.push({
+                uri: `heyseo://sites/${site.id}`,
+                name: `Site: ${site.name || site.url}`,
+                description: `Details for ${site.url}`,
+                mimeType: 'application/json',
+            });
+            resources.push({
+                uri: `heyseo://sites/${site.id}/overview`,
+                name: `Overview: ${site.name || site.url}`,
+                description: `SEO metrics overview for ${site.url}`,
+                mimeType: 'application/json',
+            });
+            resources.push({
+                uri: `heyseo://sites/${site.id}/keywords`,
+                name: `Keywords: ${site.name || site.url}`,
+                description: `Top keywords for ${site.url}`,
+                mimeType: 'application/json',
+            });
+            resources.push({
+                uri: `heyseo://sites/${site.id}/pages`,
+                name: `Pages: ${site.name || site.url}`,
+                description: `Top pages for ${site.url}`,
+                mimeType: 'application/json',
+            });
+        }
+    }
+    catch {
+        // If we can't fetch sites, just return the template
+    }
+    return resources;
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;QACE,WAAW,EAAE,gBAAgB;QAC7B,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,WAAW,EAAE,yBAAyB;QACtC,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,6BAA6B;QAC1C,QAAQ,EAAE,kBAAkB;KAC7B;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAI1C,iBAAiB;IACjB,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,0BAA0B;IAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,mCAAmC;IACnC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACzE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,mCAAmC;IACnC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACzE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,gCAAgC;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACnE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuB,EACvB,GAAW;IAEX,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAErC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,UAAU,EAAE,KAAK,CAAC,MAAM;oBACxB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACvB,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,YAAY,EAAE,CAAC,CAAC,YAAY;qBAC7B,CAAC,CAAC;iBACJ,EACD,IAAI,EACJ,CAAC,CACF;gBACD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;iBAClC,EACD,IAAI,EACJ,CAAC,CACF;gBACD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAErF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBACzC,MAAM,EAAE,CAAC;gBACT,WAAW,EAAE,CAAC;gBACd,GAAG,EAAE,CAAC;gBACN,QAAQ,EAAE,CAAC;aACZ,CAAC;YACF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;oBAC9B,GAAG,EAAE;wBACH,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,WAAW,EAAE,UAAU,CAAC,WAAW;wBACnC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBAC5C,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;qBAC5C;oBACD,GAAG,EAAE;wBACH,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,CAAC;wBAClC,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC;wBACxC,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,CAAC;wBAClC,UAAU,EAAE,UAAU,CAAC,UAAU;4BAC/B,CAAC,CAAC,GAAG,CAAE,UAAU,CAAC,UAAqB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;4BAC5D,CAAC,CAAC,KAAK;wBACT,cAAc,EAAE,UAAU,CAAC,cAAc;4BACvC,CAAC,CAAC,GAAG,CAAE,UAAU,CAAC,cAAyB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;4BAChE,CAAC,CAAC,KAAK;qBACV;iBACF,EACD,IAAI,EACJ,CAAC,CACF;gBACD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC1D,SAAS;gBACT,OAAO;gBACP,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;oBAC9B,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;oBACnC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;wBACvC,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;wBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBACrC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;qBAClC,CAAC,CAAC;iBACJ,EACD,IAAI,EACJ,CAAC,CACF;gBACD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE;gBACpD,SAAS;gBACT,OAAO;gBACP,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;oBAC9B,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;oBAC7B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;wBACjC,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;wBACjB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;wBAC5B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBACrC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;qBAClC,CAAC,CAAC;iBACJ,EACD,IAAI,EACJ,CAAC,CACF;gBACD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuB;IAEvB,MAAM,SAAS,GAKV,EAAE,CAAC;IAER,4BAA4B;IAC5B,SAAS,CAAC,IAAI,CAAC;QACb,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAC;IAEH,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,kBAAkB,IAAI,CAAC,EAAE,EAAE;gBAChC,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;gBACtC,WAAW,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE;gBACtC,QAAQ,EAAE,kBAAkB;aAC7B,CAAC,CAAC;YAEH,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,kBAAkB,IAAI,CAAC,EAAE,WAAW;gBACzC,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;gBAC1C,WAAW,EAAE,4BAA4B,IAAI,CAAC,GAAG,EAAE;gBACnD,QAAQ,EAAE,kBAAkB;aAC7B,CAAC,CAAC;YAEH,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,kBAAkB,IAAI,CAAC,EAAE,WAAW;gBACzC,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;gBAC1C,WAAW,EAAE,oBAAoB,IAAI,CAAC,GAAG,EAAE;gBAC3C,QAAQ,EAAE,kBAAkB;aAC7B,CAAC,CAAC;YAEH,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,kBAAkB,IAAI,CAAC,EAAE,QAAQ;gBACtC,IAAI,EAAE,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;gBACvC,WAAW,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE;gBACxC,QAAQ,EAAE,kBAAkB;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}