yepanywhere 0.1.0

package/dist/push/PushService.js

@@ -0,0 +1,245 @@
+/**
+ * PushService - Manages push subscriptions and sends notifications
+ *
+ * Handles:
+ * - Storing/loading push subscriptions per device
+ * - Sending push notifications via web-push
+ * - Automatic cleanup of expired/invalid subscriptions
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import webPush from "web-push";
+const CURRENT_VERSION = 1;
+export class PushService {
+    state;
+    dataDir;
+    filePath;
+    vapidKeys;
+    initialized = false;
+    savePromise = null;
+    pendingSave = false;
+    constructor(options = {}) {
+        this.dataDir =
+            options.dataDir ??
+                path.join(process.env.HOME ?? process.env.USERPROFILE ?? ".", ".yep-anywhere");
+        this.filePath = path.join(this.dataDir, "push-subscriptions.json");
+        this.vapidKeys = options.vapidKeys;
+        this.state = { version: CURRENT_VERSION, subscriptions: {} };
+    }
+    /**
+     * Initialize the service by loading state from disk.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            await fs.mkdir(this.dataDir, { recursive: true });
+            const content = await fs.readFile(this.filePath, "utf-8");
+            const parsed = JSON.parse(content);
+            if (parsed.version === CURRENT_VERSION) {
+                this.state = parsed;
+            }
+            else {
+                // Future: handle migrations
+                this.state = {
+                    version: CURRENT_VERSION,
+                    subscriptions: parsed.subscriptions ?? {},
+                };
+                await this.save();
+            }
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                console.warn("[PushService] Failed to load subscriptions, starting fresh:", error);
+            }
+            this.state = { version: CURRENT_VERSION, subscriptions: {} };
+        }
+        // Configure web-push if we have VAPID keys
+        if (this.vapidKeys) {
+            this.configureWebPush(this.vapidKeys);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Set VAPID keys (can be called after initialization).
+     */
+    setVapidKeys(keys) {
+        this.vapidKeys = keys;
+        this.configureWebPush(keys);
+    }
+    /**
+     * Configure web-push with VAPID keys.
+     */
+    configureWebPush(keys) {
+        webPush.setVapidDetails(keys.subject, keys.publicKey, keys.privateKey);
+    }
+    /**
+     * Get the VAPID public key for client subscription.
+     */
+    getPublicKey() {
+        return this.vapidKeys?.publicKey ?? null;
+    }
+    /**
+     * Subscribe a device for push notifications.
+     */
+    async subscribe(deviceId, subscription, options = {}) {
+        this.ensureInitialized();
+        this.state.subscriptions[deviceId] = {
+            subscription,
+            createdAt: new Date().toISOString(),
+            userAgent: options.userAgent,
+            deviceName: options.deviceName,
+        };
+        await this.save();
+    }
+    /**
+     * Unsubscribe a device.
+     */
+    async unsubscribe(deviceId) {
+        this.ensureInitialized();
+        if (!this.state.subscriptions[deviceId]) {
+            return false;
+        }
+        delete this.state.subscriptions[deviceId];
+        await this.save();
+        return true;
+    }
+    /**
+     * Get all subscriptions.
+     */
+    getSubscriptions() {
+        this.ensureInitialized();
+        return { ...this.state.subscriptions };
+    }
+    /**
+     * Get subscription count.
+     */
+    getSubscriptionCount() {
+        return Object.keys(this.state.subscriptions).length;
+    }
+    /**
+     * Check if a device is subscribed.
+     */
+    isSubscribed(deviceId) {
+        return !!this.state.subscriptions[deviceId];
+    }
+    /**
+     * Send a push notification to all subscribed devices.
+     */
+    async sendToAll(payload) {
+        this.ensureInitialized();
+        if (!this.vapidKeys) {
+            throw new Error("VAPID keys not configured");
+        }
+        const deviceIds = Object.keys(this.state.subscriptions);
+        if (deviceIds.length === 0) {
+            return [];
+        }
+        const results = await Promise.all(deviceIds.map((deviceId) => this.sendToDevice(deviceId, payload)));
+        // Clean up invalid subscriptions
+        await this.cleanupInvalidSubscriptions(results);
+        return results;
+    }
+    /**
+     * Send a push notification to a specific device.
+     */
+    async sendToDevice(deviceId, payload) {
+        this.ensureInitialized();
+        if (!this.vapidKeys) {
+            return {
+                deviceId,
+                success: false,
+                error: "VAPID keys not configured",
+            };
+        }
+        const stored = this.state.subscriptions[deviceId];
+        if (!stored) {
+            return {
+                deviceId,
+                success: false,
+                error: "Device not subscribed",
+            };
+        }
+        try {
+            const response = await webPush.sendNotification(stored.subscription, JSON.stringify(payload));
+            return {
+                deviceId,
+                success: true,
+                statusCode: response.statusCode,
+            };
+        }
+        catch (error) {
+            const webPushError = error;
+            return {
+                deviceId,
+                success: false,
+                error: webPushError.message,
+                statusCode: webPushError.statusCode,
+            };
+        }
+    }
+    /**
+     * Send a test notification to verify setup.
+     */
+    async sendTest(deviceId, message = "Test notification") {
+        return this.sendToDevice(deviceId, {
+            type: "test",
+            message,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Clean up subscriptions that returned 404/410 (expired/unsubscribed).
+     */
+    async cleanupInvalidSubscriptions(results) {
+        const invalidDevices = results.filter((r) => !r.success && (r.statusCode === 404 || r.statusCode === 410));
+        if (invalidDevices.length === 0)
+            return;
+        for (const { deviceId } of invalidDevices) {
+            delete this.state.subscriptions[deviceId];
+            console.log(`[PushService] Removed expired subscription: ${deviceId}`);
+        }
+        await this.save();
+    }
+    /**
+     * Ensure service is initialized.
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error("PushService not initialized. Call initialize() first.");
+        }
+    }
+    /**
+     * Save state to disk with debouncing.
+     */
+    async save() {
+        if (this.savePromise) {
+            this.pendingSave = true;
+            return;
+        }
+        this.savePromise = this.doSave();
+        await this.savePromise;
+        this.savePromise = null;
+        if (this.pendingSave) {
+            this.pendingSave = false;
+            await this.save();
+        }
+    }
+    async doSave() {
+        try {
+            const content = JSON.stringify(this.state, null, 2);
+            await fs.writeFile(this.filePath, content, "utf-8");
+        }
+        catch (error) {
+            console.error("[PushService] Failed to save subscriptions:", error);
+            throw error;
+        }
+    }
+    /**
+     * Get file path (for testing).
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=PushService.js.map

package/dist/push/PushService.js.map

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

package/dist/push/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Push notification module
+ */
+export { PushNotifier, type PushNotifierOptions } from "./PushNotifier.js";
+export { PushService, type PushServiceOptions } from "./PushService.js";
+export { createPushRoutes, type PushRoutesDeps } from "./routes.js";
+export type { DismissPayload, PendingInputPayload, PushPayload, PushPayloadType, PushSubscription, SendResult, SessionHaltedPayload, StoredSubscription, SubscriptionState, TestPayload, } from "./types.js";
+export { generateVapidKeys, getOrCreateVapidKeys, getVapidFilePath, loadVapidKeys, validateVapidKeys, type VapidKeys, } from "./vapid.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/push/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC"}

package/dist/push/index.js

@@ -0,0 +1,8 @@
+/**
+ * Push notification module
+ */
+export { PushNotifier } from "./PushNotifier.js";
+export { PushService } from "./PushService.js";
+export { createPushRoutes } from "./routes.js";
+export { generateVapidKeys, getOrCreateVapidKeys, getVapidFilePath, loadVapidKeys, validateVapidKeys, } from "./vapid.js";
+//# sourceMappingURL=index.js.map

package/dist/push/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/push/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AAapE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAElB,MAAM,YAAY,CAAC"}

package/dist/push/routes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Push notification API routes
+ */
+import { Hono } from "hono";
+import type { PushService } from "./PushService.js";
+export interface PushRoutesDeps {
+    pushService: PushService;
+}
+export declare function createPushRoutes(deps: PushRoutesDeps): Hono;
+//# sourceMappingURL=routes.d.ts.map

package/dist/push/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/push/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAiBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA2I3D"}

package/dist/push/routes.js

@@ -0,0 +1,111 @@
+/**
+ * Push notification API routes
+ */
+import { Hono } from "hono";
+export function createPushRoutes(deps) {
+    const app = new Hono();
+    const { pushService } = deps;
+    /**
+     * GET /api/push/vapid-public-key
+     * Returns the VAPID public key for client subscription
+     */
+    app.get("/vapid-public-key", (c) => {
+        const publicKey = pushService.getPublicKey();
+        if (!publicKey) {
+            return c.json({
+                error: "VAPID keys not configured",
+                hint: "Run 'pnpm setup-vapid' to generate keys",
+            }, 503);
+        }
+        return c.json({ publicKey });
+    });
+    /**
+     * POST /api/push/subscribe
+     * Subscribe a device for push notifications
+     */
+    app.post("/subscribe", async (c) => {
+        const body = await c.req.json();
+        if (!body.deviceId || typeof body.deviceId !== "string") {
+            return c.json({ error: "deviceId is required" }, 400);
+        }
+        if (!body.subscription?.endpoint || !body.subscription?.keys) {
+            return c.json({ error: "Valid subscription object is required" }, 400);
+        }
+        const userAgent = c.req.header("User-Agent");
+        await pushService.subscribe(body.deviceId, body.subscription, {
+            userAgent,
+            deviceName: body.deviceName,
+        });
+        return c.json({
+            success: true,
+            deviceId: body.deviceId,
+        });
+    });
+    /**
+     * POST /api/push/unsubscribe
+     * Unsubscribe a device from push notifications
+     */
+    app.post("/unsubscribe", async (c) => {
+        const body = await c.req.json();
+        if (!body.deviceId || typeof body.deviceId !== "string") {
+            return c.json({ error: "deviceId is required" }, 400);
+        }
+        const removed = await pushService.unsubscribe(body.deviceId);
+        return c.json({
+            success: removed,
+            deviceId: body.deviceId,
+        });
+    });
+    /**
+     * GET /api/push/subscriptions
+     * List all push subscriptions (for settings UI)
+     */
+    app.get("/subscriptions", (c) => {
+        const subscriptions = pushService.getSubscriptions();
+        // Return sanitized subscription info (hide sensitive keys)
+        const sanitized = Object.entries(subscriptions).map(([deviceId, sub]) => ({
+            deviceId,
+            createdAt: sub.createdAt,
+            deviceName: sub.deviceName,
+            // Just show domain of endpoint for privacy
+            endpointDomain: new URL(sub.subscription.endpoint).hostname,
+        }));
+        return c.json({
+            count: sanitized.length,
+            subscriptions: sanitized,
+        });
+    });
+    /**
+     * DELETE /api/push/subscriptions/:deviceId
+     * Remove a specific subscription
+     */
+    app.delete("/subscriptions/:deviceId", async (c) => {
+        const deviceId = c.req.param("deviceId");
+        const removed = await pushService.unsubscribe(deviceId);
+        if (!removed) {
+            return c.json({ error: "Subscription not found" }, 404);
+        }
+        return c.json({ success: true });
+    });
+    /**
+     * POST /api/push/test
+     * Send a test notification (for debugging)
+     */
+    app.post("/test", async (c) => {
+        const body = await c.req.json();
+        if (!body.deviceId) {
+            return c.json({ error: "deviceId is required" }, 400);
+        }
+        const result = await pushService.sendTest(body.deviceId, body.message ?? "Test notification from Yep Anywhere");
+        if (!result.success) {
+            return c.json({
+                success: false,
+                error: result.error,
+                statusCode: result.statusCode,
+            }, result.statusCode === 404 || result.statusCode === 410 ? 410 : 500);
+        }
+        return c.json({ success: true });
+    });
+    return app;
+}
+//# sourceMappingURL=routes.js.map

package/dist/push/routes.js.map

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

package/dist/push/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Push notification types
+ */
+/** Web Push subscription from the browser's PushManager */
+export interface PushSubscription {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+}
+/** Stored subscription with metadata */
+export interface StoredSubscription {
+    /** The push subscription from the browser */
+    subscription: PushSubscription;
+    /** When this subscription was created */
+    createdAt: string;
+    /** User agent of the subscribing browser */
+    userAgent?: string;
+    /** Optional friendly name for the device */
+    deviceName?: string;
+}
+/** Subscription storage state */
+export interface SubscriptionState {
+    /** Schema version for future migrations */
+    version: number;
+    /** Map of deviceId -> subscription info */
+    subscriptions: Record<string, StoredSubscription>;
+}
+/** Push notification payload types */
+export type PushPayloadType = "pending-input" | "session-halted" | "dismiss" | "test";
+/** Base push payload */
+interface BasePushPayload {
+    type: PushPayloadType;
+    timestamp: string;
+}
+/** Notification for pending input (approval/question) */
+export interface PendingInputPayload extends BasePushPayload {
+    type: "pending-input";
+    sessionId: string;
+    projectId: string;
+    projectName: string;
+    inputType: "tool-approval" | "user-question";
+    /** Brief summary of what needs approval */
+    summary: string;
+    /** ID of the input request (for approve/deny from notification) */
+    requestId: string;
+}
+/** Notification for session that stopped working */
+export interface SessionHaltedPayload extends BasePushPayload {
+    type: "session-halted";
+    sessionId: string;
+    projectId: string;
+    projectName: string;
+    reason: "completed" | "error" | "idle";
+    /** How long the session was running (ms) */
+    duration: number;
+}
+/** Dismiss notification on other devices */
+export interface DismissPayload extends BasePushPayload {
+    type: "dismiss";
+    sessionId: string;
+}
+/** Test notification */
+export interface TestPayload extends BasePushPayload {
+    type: "test";
+    message: string;
+}
+export type PushPayload = PendingInputPayload | SessionHaltedPayload | DismissPayload | TestPayload;
+/** Result of sending a push notification */
+export interface SendResult {
+    deviceId: string;
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** HTTP status code from push service */
+    statusCode?: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/push/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/push/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD;AAED,sCAAsC;AACtC,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,MAAM,CAAC;AAEX,wBAAwB;AACxB,UAAU,eAAe;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,GAAG,eAAe,CAAC;IAC7C,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,WAAW,CAAC;AAEhB,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/push/types.js

@@ -0,0 +1,5 @@
+/**
+ * Push notification types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/push/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/push/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/push/vapid.d.ts

@@ -0,0 +1,42 @@
+/**
+ * VAPID Key Management
+ *
+ * Manages VAPID (Voluntary Application Server Identification) keys for Web Push.
+ * Keys are stored in dataDir/vapid.json and reused across server restarts.
+ */
+export interface VapidKeys {
+    /** Base64url-encoded public key (for client subscription) */
+    publicKey: string;
+    /** Base64url-encoded private key (for signing push requests) */
+    privateKey: string;
+    /** Contact email for push service operators */
+    subject: string;
+}
+/**
+ * Validate VAPID key format.
+ * Public key should be 65 bytes (uncompressed P-256 point) when base64url-decoded.
+ * Private key should be 32 bytes when base64url-decoded.
+ */
+export declare function validateVapidKeys(keys: VapidKeys): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Load existing VAPID keys from disk.
+ * Returns null if file doesn't exist or is invalid.
+ */
+export declare function loadVapidKeys(filePath?: string): Promise<VapidKeys | null>;
+/**
+ * Generate new VAPID keys and save to disk.
+ */
+export declare function generateVapidKeys(filePath?: string, subject?: string): Promise<VapidKeys>;
+/**
+ * Get or create VAPID keys.
+ * Loads existing keys if available, otherwise generates new ones.
+ */
+export declare function getOrCreateVapidKeys(filePath?: string): Promise<VapidKeys>;
+/**
+ * Get VAPID file path (for external use).
+ */
+export declare function getVapidFilePath(): string;
+//# sourceMappingURL=vapid.d.ts.map

package/dist/push/vapid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapid.d.ts","sourceRoot":"","sources":["../../src/push/vapid.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAqDA;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,MAAmB,GAC5B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAmB3B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,SAAkC,GACxC,OAAO,CAAC,SAAS,CAAC,CA2BpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,GAAE,MAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAMpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}