@ucptools/validator 1.0.0 → 1.1.0

package/dist/services/monitoring-diff.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Monitoring Diff Engine
+ *
+ * Compares two ValidationResult objects to detect changes between scans.
+ * Classifies changes by severity: broken, degraded, changed, stable.
+ */
+import type { ValidationResult } from './validation.js';
+export type MonitoringSeverity = 'broken' | 'degraded' | 'changed' | 'stable';
+export interface ProfileChange {
+    field: string;
+    type: 'added' | 'removed' | 'changed';
+    oldValue?: string | number | boolean | null;
+    newValue?: string | number | boolean | null;
+    severity: 'error' | 'warn' | 'info';
+}
+export interface ProfileDiff {
+    severity: MonitoringSeverity;
+    changes: ProfileChange[];
+    summary: string;
+    scoreChange: number | null;
+    gradeChange: {
+        from: string;
+        to: string;
+    } | null;
+    ucpStatusChange: {
+        from: boolean;
+        to: boolean;
+    } | null;
+}
+export declare function diffValidationResults(previous: ValidationResult, current: ValidationResult, threshold?: number): ProfileDiff;
+//# sourceMappingURL=monitoring-diff.d.ts.map

package/dist/services/monitoring-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring-diff.d.ts","sourceRoot":"","sources":["../../src/services/monitoring-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAC;AAIzE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC5C,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,eAAe,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACxD;AAiCD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAW,GACrB,WAAW,CAmHb"}

package/dist/services/monitoring-diff.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Monitoring Diff Engine
+ *
+ * Compares two ValidationResult objects to detect changes between scans.
+ * Classifies changes by severity: broken, degraded, changed, stable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffValidationResults = diffValidationResults;
+// ── Grade ordering (lower index = better) ────────────────────────────────────
+const GRADE_ORDER = { A: 0, B: 1, C: 2, D: 3, F: 4 };
+function gradeWorsened(from, to) {
+    return (GRADE_ORDER[to] ?? 99) > (GRADE_ORDER[from] ?? 99);
+}
+function gradeImproved(from, to) {
+    return (GRADE_ORDER[to] ?? 99) < (GRADE_ORDER[from] ?? 99);
+}
+function diffIssues(prev, curr) {
+    const prevCodes = new Set(prev.map(i => i.code));
+    const currCodes = new Set(curr.map(i => i.code));
+    return {
+        added: curr.filter(i => !prevCodes.has(i.code)),
+        removed: prev.filter(i => !currCodes.has(i.code)),
+    };
+}
+// ── Core diff function ───────────────────────────────────────────────────────
+function diffValidationResults(previous, current, threshold = 10) {
+    const changes = [];
+    // 1. UCP presence
+    const ucpStatusChange = previous.ucp.found !== current.ucp.found
+        ? { from: previous.ucp.found, to: current.ucp.found }
+        : null;
+    if (ucpStatusChange) {
+        changes.push({
+            field: 'ucp.found',
+            type: 'changed',
+            oldValue: previous.ucp.found,
+            newValue: current.ucp.found,
+            severity: current.ucp.found ? 'info' : 'error',
+        });
+    }
+    // 2. Score
+    const prevScore = previous.ai_readiness.score;
+    const currScore = current.ai_readiness.score;
+    const scoreChange = currScore - prevScore;
+    if (scoreChange !== 0) {
+        changes.push({
+            field: 'ai_readiness.score',
+            type: 'changed',
+            oldValue: prevScore,
+            newValue: currScore,
+            severity: scoreChange < -threshold ? 'error' : scoreChange < 0 ? 'warn' : 'info',
+        });
+    }
+    // 3. Grade
+    const prevGrade = previous.ai_readiness.grade;
+    const currGrade = current.ai_readiness.grade;
+    const gradeChange = prevGrade !== currGrade
+        ? { from: prevGrade, to: currGrade }
+        : null;
+    if (gradeChange) {
+        changes.push({
+            field: 'ai_readiness.grade',
+            type: 'changed',
+            oldValue: prevGrade,
+            newValue: currGrade,
+            severity: gradeWorsened(prevGrade, currGrade) ? 'error' : 'info',
+        });
+    }
+    // 4. UCP issues
+    const ucpIssueDiff = diffIssues(previous.ucp.issues || [], current.ucp.issues || []);
+    for (const issue of ucpIssueDiff.added) {
+        changes.push({
+            field: `ucp.issues.${issue.code}`,
+            type: 'added',
+            newValue: issue.message,
+            severity: issue.severity === 'error' ? 'error' : 'warn',
+        });
+    }
+    for (const issue of ucpIssueDiff.removed) {
+        changes.push({
+            field: `ucp.issues.${issue.code}`,
+            type: 'removed',
+            oldValue: issue.message,
+            severity: 'info',
+        });
+    }
+    // 5. Schema issues
+    const schemaIssueDiff = diffIssues(previous.schema.issues || [], current.schema.issues || []);
+    for (const issue of schemaIssueDiff.added) {
+        changes.push({
+            field: `schema.issues.${issue.code}`,
+            type: 'added',
+            newValue: issue.message,
+            severity: issue.severity === 'error' ? 'error' : 'warn',
+        });
+    }
+    for (const issue of schemaIssueDiff.removed) {
+        changes.push({
+            field: `schema.issues.${issue.code}`,
+            type: 'removed',
+            oldValue: issue.message,
+            severity: 'info',
+        });
+    }
+    // 6. Performance grade
+    if (previous.performance?.performanceGrade !== current.performance?.performanceGrade) {
+        changes.push({
+            field: 'performance.performanceGrade',
+            type: 'changed',
+            oldValue: previous.performance?.performanceGrade ?? null,
+            newValue: current.performance?.performanceGrade ?? null,
+            severity: 'info',
+        });
+    }
+    // ── Classify severity ──────────────────────────────────────────────────────
+    const severity = classifySeverity(changes, ucpStatusChange, scoreChange, gradeChange, threshold);
+    // ── Generate summary ───────────────────────────────────────────────────────
+    const summary = generateSummary(severity, scoreChange, gradeChange, ucpStatusChange, changes);
+    return {
+        severity,
+        changes,
+        summary,
+        scoreChange: scoreChange !== 0 ? scoreChange : null,
+        gradeChange,
+        ucpStatusChange,
+    };
+}
+// ── Severity classification ──────────────────────────────────────────────────
+function classifySeverity(changes, ucpStatusChange, scoreChange, gradeChange, threshold) {
+    // Broken: UCP profile disappeared or score dropped to 0
+    if (ucpStatusChange && ucpStatusChange.from === true && ucpStatusChange.to === false) {
+        return 'broken';
+    }
+    // Degraded: grade worsened, or score dropped >= threshold, or new error-severity issues
+    if (gradeChange && gradeWorsened(gradeChange.from, gradeChange.to)) {
+        return 'degraded';
+    }
+    if (scoreChange <= -threshold) {
+        return 'degraded';
+    }
+    const hasNewErrors = changes.some(c => c.type === 'added' && c.severity === 'error');
+    if (hasNewErrors) {
+        return 'degraded';
+    }
+    // Stable: no meaningful changes at all, or only a tiny score fluctuation
+    if (changes.length === 0) {
+        return 'stable';
+    }
+    const onlySmallScoreChange = changes.every(c => c.field === 'ai_readiness.score') && Math.abs(scoreChange) <= 2;
+    if (onlySmallScoreChange) {
+        return 'stable';
+    }
+    // Changed: anything else (improvements, informational changes)
+    return 'changed';
+}
+// ── Summary generation ───────────────────────────────────────────────────────
+function generateSummary(severity, scoreChange, gradeChange, ucpStatusChange, changes) {
+    if (severity === 'stable') {
+        return 'No meaningful changes detected';
+    }
+    const parts = [];
+    if (ucpStatusChange) {
+        if (!ucpStatusChange.to) {
+            parts.push('UCP profile no longer found');
+        }
+        else {
+            parts.push('UCP profile restored');
+        }
+    }
+    if (scoreChange !== 0) {
+        const direction = scoreChange > 0 ? 'improved' : 'dropped';
+        parts.push(`Score ${direction} by ${Math.abs(scoreChange)} points`);
+    }
+    if (gradeChange) {
+        const direction = gradeImproved(gradeChange.from, gradeChange.to) ? 'improved' : 'dropped';
+        parts.push(`Grade ${direction} from ${gradeChange.from} to ${gradeChange.to}`);
+    }
+    const newErrors = changes.filter(c => c.type === 'added' && c.severity === 'error');
+    if (newErrors.length > 0) {
+        parts.push(`${newErrors.length} new error(s)`);
+    }
+    const resolvedIssues = changes.filter(c => c.type === 'removed');
+    if (resolvedIssues.length > 0) {
+        parts.push(`${resolvedIssues.length} issue(s) resolved`);
+    }
+    return parts.join('. ') || 'Profile changes detected';
+}
+//# sourceMappingURL=monitoring-diff.js.map

package/dist/services/monitoring-diff.js.map

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

package/dist/services/notifications.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Notification Service
+ *
+ * Handles outbound notifications via Slack webhooks.
+ * All notifications are fire-and-forget to avoid blocking main operations.
+ */
+export interface NotificationUser {
+    id: string;
+    email: string;
+    name: string | null;
+}
+export interface NotificationSubscription {
+    tier: string;
+    status: string;
+}
+/**
+ * Send signup notification to Slack
+ */
+export interface WebhookPayload {
+    event: 'profile_broken' | 'profile_degraded' | 'profile_changed';
+    domain: string;
+    severity: string;
+    oldScore: number | null;
+    newScore: number;
+    oldGrade: string | null;
+    newGrade: string;
+    changes: Array<{
+        field: string;
+        type: string;
+        oldValue?: string | number | boolean | null;
+        newValue?: string | number | boolean | null;
+    }>;
+    summary: string;
+    timestamp: string;
+    dashboardUrl: string;
+}
+/**
+ * Send webhook notification for domain monitoring changes.
+ * Fire-and-forget - logs errors but never throws.
+ */
+export declare function sendDomainWebhook(webhookUrl: string, payload: WebhookPayload): Promise<boolean>;
+/**
+ * Send signup notification to Slack
+ */
+export declare function notifySignup(user: NotificationUser, subscription: NotificationSubscription): Promise<void>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/services/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/services/notifications.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;QAC5C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;KAC7C,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,EACtB,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/services/notifications.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Notification Service
+ *
+ * Handles outbound notifications via Slack webhooks.
+ * All notifications are fire-and-forget to avoid blocking main operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendDomainWebhook = sendDomainWebhook;
+exports.notifySignup = notifySignup;
+/**
+ * Send webhook notification for domain monitoring changes.
+ * Fire-and-forget - logs errors but never throws.
+ */
+async function sendDomainWebhook(webhookUrl, payload) {
+    try {
+        const response = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': 'UCPtools-Webhook/1.0',
+            },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(10000), // 10s timeout
+        });
+        if (!response.ok) {
+            console.error(`[Webhook] Failed to send to ${webhookUrl}: ${response.status}`);
+            return false;
+        }
+        console.log(`[Webhook] Sent ${payload.event} notification for ${payload.domain}`);
+        return true;
+    }
+    catch (error) {
+        console.error(`[Webhook] Error sending to ${webhookUrl}:`, error instanceof Error ? error.message : error);
+        return false;
+    }
+}
+/**
+ * Send signup notification to Slack
+ */
+async function notifySignup(user, subscription) {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) {
+        console.log('[Slack] No webhook URL configured, skipping notification');
+        return;
+    }
+    const message = {
+        blocks: [
+            {
+                type: 'header',
+                text: { type: 'plain_text', text: '🎉 New Customer Signup!' }
+            },
+            {
+                type: 'section',
+                fields: [
+                    { type: 'mrkdwn', text: `*Email:*\n${user.email}` },
+                    { type: 'mrkdwn', text: `*Name:*\n${user.name || 'Not provided'}` },
+                    { type: 'mrkdwn', text: `*Tier:*\n${subscription.tier}` },
+                    { type: 'mrkdwn', text: `*Status:*\n${subscription.status}` }
+                ]
+            },
+            {
+                type: 'context',
+                elements: [
+                    { type: 'mrkdwn', text: `User ID: ${user.id} | ${new Date().toISOString()}` }
+                ]
+            }
+        ]
+    };
+    // Fire-and-forget - don't await, don't block
+    fetch(webhookUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(message)
+    })
+        .then(response => {
+        if (!response.ok) {
+            console.error(`[Slack] Notification failed: ${response.status}`);
+        }
+        else {
+            console.log(`[Slack] Signup notification sent for ${user.email}`);
+        }
+    })
+        .catch(err => {
+        console.error('[Slack] Notification error:', err.message);
+    });
+}
+//# sourceMappingURL=notifications.js.map

package/dist/services/notifications.js.map

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

package/dist/services/stripe.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Stripe Service
+ * Handles all Stripe-related operations including:
+ * - Checkout session creation
+ * - Subscription management
+ * - Customer portal
+ * - Webhook events
+ * Production deployment ready
+ */
+import Stripe from 'stripe';
+type SubscriptionTier = 'free' | 'starter' | 'pro' | 'business';
+/**
+ * Get the Stripe instance, throwing an error if not configured.
+ * This allows the app to start even without Stripe keys,
+ * failing only when Stripe features are actually used.
+ */
+export declare function getStripe(): Stripe;
+export declare const stripe: Stripe;
+export declare const STRIPE_PRICE_IDS: {
+    starter_monthly: string;
+    starter_annual: string;
+    pro_monthly: string;
+    pro_annual: string;
+    business_monthly: string;
+    business_annual: string;
+};
+/**
+ * Map Stripe price ID to subscription tier
+ */
+export declare function priceIdToTier(priceId: string): SubscriptionTier;
+/**
+ * Create a Stripe checkout session for a new subscription
+ */
+export declare function createCheckoutSession(params: {
+    userId: string;
+    userEmail: string;
+    priceId: string;
+    successUrl: string;
+    cancelUrl: string;
+    trialDays?: number;
+}): Promise<Stripe.Checkout.Session>;
+/**
+ * Create a customer portal session for managing subscription
+ */
+export declare function createCustomerPortalSession(params: {
+    customerId: string;
+    returnUrl: string;
+}): Promise<Stripe.BillingPortal.Session>;
+/**
+ * Start a free trial without requiring a credit card
+ * Creates a Stripe customer for future conversion, and a local subscription record
+ *
+ * @param userId - The user's ID in our database
+ * @param userEmail - The user's email address
+ * @param userName - Optional user name
+ * @param trialDays - Number of trial days (default 7)
+ * @returns The created Stripe customer ID and trial end date
+ */
+export declare function startTrialWithoutPayment(params: {
+    userId: string;
+    userEmail: string;
+    userName?: string;
+    trialDays?: number;
+}): Promise<{
+    customerId: string;
+    trialEndsAt: Date;
+}>;
+/**
+ * Handle Stripe webhook events
+ */
+export declare function handleWebhookEvent(event: Stripe.Event): Promise<void>;
+/**
+ * Verify Stripe webhook signature
+ */
+export declare function verifyWebhookSignature(payload: string | Buffer, signature: string, secret: string): Stripe.Event;
+/**
+ * Get subscription details for a user
+ */
+export declare function getSubscriptionDetails(stripeSubscriptionId: string): Promise<Stripe.Subscription | null>;
+/**
+ * Cancel a subscription at period end
+ */
+export declare function cancelSubscription(stripeSubscriptionId: string): Promise<Stripe.Subscription>;
+/**
+ * Resume a canceled subscription
+ */
+export declare function resumeSubscription(stripeSubscriptionId: string): Promise<Stripe.Subscription>;
+/**
+ * Update subscription to a new price (upgrade/downgrade)
+ */
+export declare function updateSubscription(stripeSubscriptionId: string, newPriceId: string): Promise<Stripe.Subscription>;
+export {};
+//# sourceMappingURL=stripe.d.ts.map

package/dist/services/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/services/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAQ5B,KAAK,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAgBhE;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAQlC;AAGD,eAAO,MAAM,MAAM,QAIjB,CAAC;AAKH,eAAO,MAAM,gBAAgB;;;;;;;CAsB5B,CAAC;AAUF;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA6B/D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAuDnC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAQxC;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,CAAC,CAiDrD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C3E;AAuLD;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,MAAM,CAAC,KAAK,CAEd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9G;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAInG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAInG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,oBAAoB,EAAE,MAAM,EAC5B,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAY9B"}