@cesteral/snapchat-mcp 1.0.0

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js

@@ -0,0 +1,148 @@
+let cachedContent;
+function formatReportingReferenceMarkdown() {
+    return `# Snapchat Ads Reporting Reference
+
+## Report Types
+
+| Report Type | Description |
+|-------------|-------------|
+| BASIC | Standard delivery and performance metrics |
+| AUDIENCE | Audience breakdown metrics (requires audience dimensions) |
+| PLAYABLE_MATERIAL | Playable ad performance metrics |
+
+## Async Reporting Flow
+
+1. **Submit**: POST \`/v1/adaccounts/{ad_account_id}/stats/async_reporting\` → get \`report_id\`
+2. **Poll**: GET \`/v1/adaccounts/{ad_account_id}/stats/async_reports/{report_id}\` → check \`status\`
+3. **Download**: GET the \`download_url\` when status = "COMPLETE"
+
+Status values: PENDING → RUNNING → COMPLETE | FAILED
+
+Use \`snapchat_get_report\` or \`snapchat_get_report_breakdowns\` — these tools handle the full flow automatically.
+
+## Common Dimensions
+
+### Time Dimensions
+| Dimension | Description |
+|-----------|-------------|
+| stat_time_day | Daily breakdown (YYYY-MM-DD) |
+| stat_time_hour | Hourly breakdown |
+
+### Entity Dimensions
+| Dimension | Description |
+|-----------|-------------|
+| ad_account_id | Advertiser ID |
+| campaign_id | Campaign ID |
+| adgroup_id | Ad group ID |
+| ad_id | Ad ID |
+
+### Audience Dimensions (AUDIENCE report type)
+| Dimension | Description |
+|-----------|-------------|
+| gender | User gender breakdown |
+| age | User age group breakdown |
+| country_code | Country (ISO 2-letter code) |
+| province_id | Province/region ID |
+| platform | Operating system platform |
+| device_brand_id | Device brand |
+| interest_category | Interest category |
+| placement | Ad placement |
+| language | User language |
+
+## Common Metrics
+
+### Delivery Metrics
+| Metric | Description |
+|--------|-------------|
+| impressions | Total impressions |
+| reach | Unique users reached |
+| frequency | Average impressions per user |
+| clicks | Total clicks |
+| ctr | Click-through rate (%) |
+| cpm | Cost per mille (per 1000 impressions) |
+| cpc | Cost per click |
+| spend | Total amount spent |
+
+### Video Metrics
+| Metric | Description |
+|--------|-------------|
+| video_play_actions | Total video plays |
+| video_watched_2s | 2-second video views |
+| video_watched_6s | 6-second video views |
+| video_views_p25 | 25% video completion |
+| video_views_p50 | 50% video completion |
+| video_views_p75 | 75% video completion |
+| video_views_p100 | 100% completion (full views) |
+| average_video_play | Average play duration (seconds) |
+
+### Conversion Metrics
+| Metric | Description |
+|--------|-------------|
+| conversions | Total conversion events |
+| conversion_rate | Conversions / clicks (%) |
+| cost_per_conversion | Spend / conversions |
+| real_time_conversions | Real-time tracked conversions |
+| total_purchase_value | Total purchase value |
+| total_sales | Total sales count |
+| cost_per_1000_reached | CPM by unique reach |
+
+### Engagement Metrics
+| Metric | Description |
+|--------|-------------|
+| profile_visits | Profile page visits |
+| follows | New followers gained |
+| likes | Likes on ads |
+| comments | Comments on ads |
+| shares | Shares of ads |
+| engaged_view | Engaged views (6s+ or interaction) |
+
+## Example Report Configurations
+
+### Campaign Daily Delivery Report
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "reportType": "BASIC",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "metrics": ["impressions", "clicks", "spend", "ctr", "cpc"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+
+### Ad Performance with Video Metrics
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "reportType": "BASIC",
+  "dimensions": ["ad_id"],
+  "metrics": ["impressions", "spend", "video_play_actions", "video_views_p100", "average_video_play"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+
+### Country Breakdown Report
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "breakdowns": ["country_code"],
+  "metrics": ["impressions", "clicks", "spend", "conversions"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+`;
+}
+export const reportingReferenceResource = {
+    uri: "reporting-reference://snapchat",
+    name: "Snapchat Reporting Reference",
+    description: "Available dimensions, metrics, report types, and example configurations for Snapchat Ads reporting",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatReportingReferenceMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=reporting-reference.resource.js.map

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAQA,IAAI,aAAiC,CAAC;AAEtC,SAAS,gCAAgC;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,gCAAgC;IACrC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,oGAAoG;IACtG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,gCAAgC,EAAE,CAAC;QACrD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/mcp-server/resources/index.d.ts

@@ -0,0 +1,3 @@
+export type { Resource } from "./types.js";
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/index.js

@@ -0,0 +1,2 @@
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/types.d.ts

@@ -0,0 +1,8 @@
+export interface Resource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    getContent: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp-server/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IAEvB,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B"}

package/dist/mcp-server/resources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp-server/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "pino";
+export declare function createMcpServer(logger: Logger, sessionId?: string, gcsBucket?: string): Promise<McpServer>;
+export declare function runStdioServer(server: McpServer, logger: Logger): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAmBtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAmCnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAkIpB;AAKD,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}

package/dist/mcp-server/server.js

@@ -0,0 +1,134 @@
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { allTools } from "./tools/index.js";
+import { allResources } from "./resources/index.js";
+import { promptRegistry } from "./prompts/index.js";
+import { createOperationContext } from "@cesteral/shared";
+import { reportCsvStore, sessionServiceStore } from "../services/session-services.js";
+import { extractZodShape, registerReportCsvResource, registerToolsFromDefinitions, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
+import packageJson from "../../package.json" with { type: "json" };
+const SNAPCHAT_PACKAGE_NAME = "snapchat-mcp";
+const SNAPCHAT_PLATFORM = "snapchat";
+const snapchatWorkflowIdByToolName = {
+    snapchat_list_entities: "mcp.execute.snapchat_entity_read",
+    snapchat_get_entity: "mcp.execute.snapchat_entity_read",
+    snapchat_list_ad_accounts: "mcp.execute.snapchat_entity_read",
+    snapchat_create_entity: "mcp.execute.snapchat_entity_update",
+    snapchat_update_entity: "mcp.execute.snapchat_entity_update",
+    snapchat_delete_entity: "mcp.execute.snapchat_entity_update",
+    snapchat_get_report: "mcp.execute.snapchat_reporting",
+    snapchat_get_report_breakdowns: "mcp.execute.snapchat_reporting",
+    snapchat_bulk_update_status: "mcp.execute.snapchat_bulk_operations",
+    snapchat_bulk_create_entities: "mcp.execute.snapchat_bulk_operations",
+    snapchat_bulk_update_entities: "mcp.execute.snapchat_bulk_operations",
+    snapchat_adjust_bids: "mcp.execute.snapchat_bulk_operations",
+    snapchat_search_targeting: "mcp.execute.snapchat_entity_read",
+    snapchat_get_targeting_options: "mcp.execute.snapchat_entity_read",
+    snapchat_get_audience_estimate: "mcp.execute.snapchat_entity_read",
+    snapchat_get_ad_preview: "mcp.execute.snapchat_entity_read",
+    snapchat_validate_entity: "mcp.execute.snapchat_entity_read",
+};
+export async function createMcpServer(logger, sessionId, gcsBucket) {
+    const server = new McpServer({
+        name: "snapchat-mcp",
+        version: packageJson.version,
+        description: "Snapchat Ads campaign management and reporting via the Snap Marketing API. Supports campaign, ad squad, ad, creative, and audience workflows with reporting, targeting, bid adjustments, and previews.",
+    }, {
+        capabilities: {
+            logging: {},
+        },
+        instructions: "Snapchat Ads campaign management and reporting server. Supports campaign, ad squad, ad, creative, and audience workflows with async reporting, targeting, bid adjustments, and bulk operations via the Snap Marketing API. " +
+            "Progressive discovery: (1) start with snapchat_list_ad_accounts to resolve accessible account IDs, then snapchat_list_entities to browse campaigns/adSquads/ads/creatives; " +
+            "(2) before authoring writes, read MCP Resources entity-schema://snapchat/all for field shapes, entity-hierarchy://snapchat/all for parent/child rules, entity-examples://snapchat/all for payloads, and reporting-reference://snapchat for stats fields and breakdowns; " +
+            "(3) for multi-step flows use MCP Prompts: snapchat_campaign_setup_workflow, snapchat_reporting_workflow, snapchat_targeting_discovery_workflow, creative_upload_workflow, snapchat_bulk_operations_workflow.",
+    });
+    const interactionLogger = new InteractionLogger({
+        serverName: SNAPCHAT_PACKAGE_NAME,
+        logger,
+        gcsBucket,
+    });
+    registerToolsFromDefinitions({
+        server,
+        tools: allTools,
+        logger,
+        sessionId,
+        transformSchema: (schema) => extractZodShape(schema),
+        createRequestContext: (params) => createOperationContext({
+            operation: params.operation,
+            additionalContext: params.additionalContext,
+        }),
+        defaultTextFormat: "compact",
+        packageName: SNAPCHAT_PACKAGE_NAME,
+        platform: SNAPCHAT_PLATFORM,
+        workflowIdByToolName: snapchatWorkflowIdByToolName,
+        interactionLogger,
+        authContextResolver: sessionId
+            ? () => sessionServiceStore.getAuthContext(sessionId)
+            : undefined,
+    });
+    registerStaticResourcesFromDefinitions({
+        server,
+        resources: allResources,
+        logger,
+    });
+    registerReportCsvResource({
+        server,
+        ResourceTemplate,
+        store: reportCsvStore,
+        platform: "Snapchat",
+        downloadToolName: "snapchat_download_report",
+        logger,
+    });
+    if (isConformanceFixturesEnabled()) {
+        const { conformanceResources, conformanceResourceTemplate, conformancePrompts } = await import("@cesteral/shared");
+        const { ResourceTemplate: McpResourceTemplate } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+        registerStaticResourcesFromDefinitions({
+            server,
+            resources: conformanceResources,
+            logger,
+        });
+        const template = new McpResourceTemplate(conformanceResourceTemplate.uriTemplate, {
+            list: undefined,
+        });
+        server.registerResource("conformance_template", template, {
+            description: conformanceResourceTemplate.description,
+            mimeType: conformanceResourceTemplate.mimeType,
+        }, async (uri, variables) => {
+            const id = variables.id || "unknown";
+            const content = conformanceResourceTemplate.getContent(id);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: conformanceResourceTemplate.mimeType,
+                        text: content,
+                    },
+                ],
+            };
+        });
+        registerPromptsFromDefinitions({
+            server: server,
+            prompts: conformancePrompts,
+            logger,
+        });
+    }
+    const allPrompts = Array.from(promptRegistry.values()).map((def) => ({
+        name: def.prompt.name,
+        description: def.prompt.description ?? "",
+        arguments: def.prompt.arguments,
+        generateMessage: def.generateMessage,
+    }));
+    registerPromptsFromDefinitions({
+        server: server,
+        prompts: allPrompts,
+        logger,
+    });
+    return server;
+}
+export async function runStdioServer(server, logger) {
+    logger.info("Starting MCP server with stdio transport");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server connected via stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp-server/server.js.map

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

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts

@@ -0,0 +1,209 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const AdjustBidsInputSchema: z.ZodObject<{
+    adAccountId: z.ZodString;
+    adjustments: z.ZodArray<z.ZodObject<{
+        adGroupId: z.ZodString;
+        bidPrice: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        adGroupId: string;
+        bidPrice: number;
+    }, {
+        adGroupId: string;
+        bidPrice: number;
+    }>, "many">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountId: string;
+    adjustments: {
+        adGroupId: string;
+        bidPrice: number;
+    }[];
+    reason?: string | undefined;
+}, {
+    adAccountId: string;
+    adjustments: {
+        adGroupId: string;
+        bidPrice: number;
+    }[];
+    reason?: string | undefined;
+}>;
+export declare const AdjustBidsOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    totalRequested: z.ZodNumber;
+    totalSucceeded: z.ZodNumber;
+    totalFailed: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        adGroupId: z.ZodString;
+        success: z.ZodBoolean;
+        previousBid: z.ZodOptional<z.ZodNumber>;
+        newBid: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        adGroupId: string;
+        error?: string | undefined;
+        previousBid?: number | undefined;
+        newBid?: number | undefined;
+    }, {
+        success: boolean;
+        adGroupId: string;
+        error?: string | undefined;
+        previousBid?: number | undefined;
+        newBid?: number | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        success: boolean;
+        adGroupId: string;
+        error?: string | undefined;
+        previousBid?: number | undefined;
+        newBid?: number | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        success: boolean;
+        adGroupId: string;
+        error?: string | undefined;
+        previousBid?: number | undefined;
+        newBid?: number | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}>;
+type AdjustBidsInput = z.infer<typeof AdjustBidsInputSchema>;
+type AdjustBidsOutput = z.infer<typeof AdjustBidsOutputSchema>;
+export declare function adjustBidsLogic(input: AdjustBidsInput, context: RequestContext, sdkContext?: SdkContext): Promise<AdjustBidsOutput>;
+export declare function adjustBidsResponseFormatter(result: AdjustBidsOutput): McpTextContent[];
+export declare const adjustBidsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adAccountId: z.ZodString;
+        adjustments: z.ZodArray<z.ZodObject<{
+            adGroupId: z.ZodString;
+            bidPrice: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            adGroupId: string;
+            bidPrice: number;
+        }, {
+            adGroupId: string;
+            bidPrice: number;
+        }>, "many">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountId: string;
+        adjustments: {
+            adGroupId: string;
+            bidPrice: number;
+        }[];
+        reason?: string | undefined;
+    }, {
+        adAccountId: string;
+        adjustments: {
+            adGroupId: string;
+            bidPrice: number;
+        }[];
+        reason?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        totalRequested: z.ZodNumber;
+        totalSucceeded: z.ZodNumber;
+        totalFailed: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            adGroupId: z.ZodString;
+            success: z.ZodBoolean;
+            previousBid: z.ZodOptional<z.ZodNumber>;
+            newBid: z.ZodOptional<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            success: boolean;
+            adGroupId: string;
+            error?: string | undefined;
+            previousBid?: number | undefined;
+            newBid?: number | undefined;
+        }, {
+            success: boolean;
+            adGroupId: string;
+            error?: string | undefined;
+            previousBid?: number | undefined;
+            newBid?: number | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            success: boolean;
+            adGroupId: string;
+            error?: string | undefined;
+            previousBid?: number | undefined;
+            newBid?: number | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            success: boolean;
+            adGroupId: string;
+            error?: string | undefined;
+            previousBid?: number | undefined;
+            newBid?: number | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            adAccountId: string;
+            adjustments: {
+                adGroupId: string;
+                bidPrice: number;
+            }[];
+            reason?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            adAccountId: string;
+            adjustments: {
+                adGroupId: string;
+                bidPrice: number;
+            }[];
+            reason: string;
+        };
+    })[];
+    logic: typeof adjustBidsLogic;
+    responseFormatter: typeof adjustBidsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=adjust-bids.tool.d.ts.map

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-bids.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAesC,CAAC;AAEzE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBE,CAAC;AAEtC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAwC3B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CA0BtF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC"}