@porulle/plugin-appointments 0.1.0

package/dist/services/provider-service.d.ts

@@ -0,0 +1,328 @@
+import type { Db } from "../types.js";
+export declare class ProviderService {
+    private db;
+    constructor(db: Db);
+    createServiceType(orgId: string, data: {
+        name: string;
+        slug: string;
+        description?: string;
+        durationMinutes?: number;
+        priceCents?: number;
+        currency?: string;
+        bufferBeforeMinutes?: number;
+        bufferAfterMinutes?: number;
+    }): Promise<{
+        id: string;
+        createdAt: Date;
+        name: string;
+        organizationId: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        updatedAt: Date;
+    } | undefined>;
+    getServiceType(id: string): Promise<{
+        id: string;
+        organizationId: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    getServiceTypeBySlug(slug: string): Promise<{
+        id: string;
+        organizationId: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    listServiceTypes(): Promise<{
+        id: string;
+        organizationId: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    updateServiceType(id: string, data: Partial<{
+        name: string;
+        description: string;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        isActive: boolean;
+    }>): Promise<{
+        id: string;
+        organizationId: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    deleteServiceType(id: string): Promise<{
+        id: string;
+        createdAt: Date;
+        name: string;
+        organizationId: string;
+        slug: string;
+        description: string | null;
+        durationMinutes: number;
+        priceCents: number;
+        currency: string;
+        mode: string;
+        bufferBeforeMinutes: number;
+        bufferAfterMinutes: number;
+        maxAdvanceDays: number;
+        minNoticeMins: number;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        updatedAt: Date;
+    } | null>;
+    createProvider(orgId: string, data: {
+        name: string;
+        email?: string;
+        phone?: string;
+        timezone?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+        createdAt: Date;
+        name: string;
+        organizationId: string;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        updatedAt: Date;
+        userId: string | null;
+        bio: string | null;
+        email: string | null;
+        phone: string | null;
+        timezone: string;
+    } | undefined>;
+    getProvider(id: string): Promise<{
+        id: string;
+        organizationId: string;
+        userId: string | null;
+        name: string;
+        bio: string | null;
+        email: string | null;
+        phone: string | null;
+        timezone: string;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    listProviders(): Promise<{
+        id: string;
+        organizationId: string;
+        userId: string | null;
+        name: string;
+        bio: string | null;
+        email: string | null;
+        phone: string | null;
+        timezone: string;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    updateProvider(id: string, data: Partial<{
+        name: string;
+        email: string;
+        phone: string;
+        timezone: string;
+        isActive: boolean;
+        metadata: Record<string, unknown>;
+    }>): Promise<{
+        id: string;
+        organizationId: string;
+        userId: string | null;
+        name: string;
+        bio: string | null;
+        email: string | null;
+        phone: string | null;
+        timezone: string;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    deleteProvider(id: string): Promise<{
+        id: string;
+        createdAt: Date;
+        name: string;
+        organizationId: string;
+        isActive: boolean;
+        metadata: Record<string, unknown> | null;
+        updatedAt: Date;
+        userId: string | null;
+        bio: string | null;
+        email: string | null;
+        phone: string | null;
+        timezone: string;
+    } | null>;
+    linkServiceType(providerId: string, serviceTypeId: string, overrides?: {
+        customDurationMinutes?: number;
+        customPriceCents?: number;
+    }): Promise<{
+        id: string;
+        providerId: string;
+        serviceTypeId: string;
+        createdAt: Date;
+        customDurationMinutes: number | null;
+        customPriceCents: number | null;
+    } | undefined>;
+    getProviderServices(providerId: string): Promise<{
+        id: string;
+        providerId: string;
+        serviceTypeId: string;
+        customDurationMinutes: number | null;
+        customPriceCents: number | null;
+        createdAt: Date;
+    }[]>;
+    setWeeklyAvailability(providerId: string, schedules: Array<{
+        dayOfWeek: number;
+        startTime: string;
+        endTime: string;
+    }>): Promise<{
+        id: string;
+        providerId: string;
+        startTime: string;
+        createdAt: Date;
+        dayOfWeek: number;
+        endTime: string;
+    }[]>;
+    getWeeklyAvailability(providerId: string): Promise<{
+        id: string;
+        providerId: string;
+        dayOfWeek: number;
+        startTime: string;
+        endTime: string;
+        createdAt: Date;
+    }[]>;
+    addBreak(providerId: string, data: {
+        dayOfWeek?: number | undefined;
+        startTime: string;
+        endTime: string;
+        label?: string | undefined;
+    }): Promise<{
+        id: string;
+        providerId: string;
+        startTime: string;
+        createdAt: Date;
+        dayOfWeek: number | null;
+        endTime: string;
+        label: string | null;
+    } | undefined>;
+    getBreaks(providerId: string): Promise<{
+        id: string;
+        providerId: string;
+        dayOfWeek: number | null;
+        startTime: string;
+        endTime: string;
+        label: string | null;
+        createdAt: Date;
+    }[]>;
+    deleteBreak(id: string): Promise<{
+        id: string;
+        providerId: string;
+        startTime: string;
+        createdAt: Date;
+        dayOfWeek: number | null;
+        endTime: string;
+        label: string | null;
+    } | null>;
+    addOverride(providerId: string, data: {
+        date: string;
+        isAvailable: boolean;
+        startTime?: string | undefined;
+        endTime?: string | undefined;
+        reason?: string | undefined;
+    }): Promise<{
+        id: string;
+        providerId: string;
+        startTime: string | null;
+        createdAt: Date;
+        date: string;
+        endTime: string | null;
+        isAvailable: boolean;
+        reason: string | null;
+    } | undefined>;
+    getOverrides(providerId: string): Promise<{
+        id: string;
+        providerId: string;
+        date: string;
+        isAvailable: boolean;
+        startTime: string | null;
+        endTime: string | null;
+        reason: string | null;
+        createdAt: Date;
+    }[]>;
+    deleteOverride(id: string): Promise<{
+        id: string;
+        providerId: string;
+        startTime: string | null;
+        createdAt: Date;
+        date: string;
+        endTime: string | null;
+        isAvailable: boolean;
+        reason: string | null;
+    } | null>;
+}
+//# sourceMappingURL=provider-service.d.ts.map

package/dist/services/provider-service.d.ts.map

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

package/dist/services/provider-service.js

@@ -0,0 +1,152 @@
+import { eq, desc } from "@porulle/core/drizzle";
+import { serviceTypes, providers, providerServices, weeklyAvailability, availabilityOverrides, breaks, } from "../schema.js";
+export class ProviderService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ─── Service Types ──────────────────────────────────────────────────────────
+    async createServiceType(orgId, data) {
+        const [row] = await this.db.insert(serviceTypes).values({
+            organizationId: orgId,
+            name: data.name,
+            slug: data.slug,
+            description: data.description,
+            durationMinutes: data.durationMinutes ?? 30,
+            priceCents: data.priceCents ?? 0,
+            currency: data.currency ?? "USD",
+            bufferBeforeMinutes: data.bufferBeforeMinutes ?? 0,
+            bufferAfterMinutes: data.bufferAfterMinutes ?? 0,
+        }).returning();
+        return row;
+    }
+    async getServiceType(id) {
+        const [row] = await this.db.select().from(serviceTypes).where(eq(serviceTypes.id, id));
+        return row ?? null;
+    }
+    async getServiceTypeBySlug(slug) {
+        const [row] = await this.db.select().from(serviceTypes).where(eq(serviceTypes.slug, slug));
+        return row ?? null;
+    }
+    async listServiceTypes() {
+        return this.db.select().from(serviceTypes).where(eq(serviceTypes.isActive, true)).orderBy(desc(serviceTypes.createdAt));
+    }
+    async updateServiceType(id, data) {
+        const [updated] = await this.db.update(serviceTypes)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(serviceTypes.id, id))
+            .returning();
+        return updated ?? null;
+    }
+    async deleteServiceType(id) {
+        const [deleted] = await this.db.delete(serviceTypes).where(eq(serviceTypes.id, id)).returning();
+        return deleted ?? null;
+    }
+    // ─── Providers ──────────────────────────────────────────────────────────────
+    async createProvider(orgId, data) {
+        const [row] = await this.db.insert(providers).values({
+            organizationId: orgId,
+            name: data.name,
+            email: data.email,
+            phone: data.phone,
+            timezone: data.timezone ?? "UTC",
+            metadata: data.metadata ?? {},
+        }).returning();
+        return row;
+    }
+    async getProvider(id) {
+        const [row] = await this.db.select().from(providers).where(eq(providers.id, id));
+        return row ?? null;
+    }
+    async listProviders() {
+        return this.db.select().from(providers).where(eq(providers.isActive, true)).orderBy(desc(providers.createdAt));
+    }
+    async updateProvider(id, data) {
+        const [updated] = await this.db.update(providers)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(providers.id, id))
+            .returning();
+        return updated ?? null;
+    }
+    async deleteProvider(id) {
+        const [deleted] = await this.db.delete(providers).where(eq(providers.id, id)).returning();
+        return deleted ?? null;
+    }
+    // ─── Provider–ServiceType Links ─────────────────────────────────────────────
+    async linkServiceType(providerId, serviceTypeId, overrides) {
+        const [row] = await this.db.insert(providerServices).values({
+            providerId,
+            serviceTypeId,
+            customDurationMinutes: overrides?.customDurationMinutes,
+            customPriceCents: overrides?.customPriceCents,
+        }).returning();
+        return row;
+    }
+    async getProviderServices(providerId) {
+        return this.db.select().from(providerServices)
+            .where(eq(providerServices.providerId, providerId));
+    }
+    // ─── Weekly Availability ────────────────────────────────────────────────────
+    async setWeeklyAvailability(providerId, schedules) {
+        // Delete existing weekly availability for this provider
+        await this.db.delete(weeklyAvailability)
+            .where(eq(weeklyAvailability.providerId, providerId));
+        if (schedules.length === 0)
+            return [];
+        const rows = await this.db.insert(weeklyAvailability)
+            .values(schedules.map((s) => ({
+            providerId,
+            dayOfWeek: s.dayOfWeek,
+            startTime: s.startTime,
+            endTime: s.endTime,
+        })))
+            .returning();
+        return rows;
+    }
+    async getWeeklyAvailability(providerId) {
+        return this.db.select().from(weeklyAvailability)
+            .where(eq(weeklyAvailability.providerId, providerId))
+            .orderBy(weeklyAvailability.dayOfWeek);
+    }
+    // ─── Breaks ─────────────────────────────────────────────────────────────────
+    async addBreak(providerId, data) {
+        const [row] = await this.db.insert(breaks).values({
+            providerId,
+            dayOfWeek: data.dayOfWeek,
+            startTime: data.startTime,
+            endTime: data.endTime,
+            label: data.label,
+        }).returning();
+        return row;
+    }
+    async getBreaks(providerId) {
+        return this.db.select().from(breaks)
+            .where(eq(breaks.providerId, providerId));
+    }
+    async deleteBreak(id) {
+        const [deleted] = await this.db.delete(breaks).where(eq(breaks.id, id)).returning();
+        return deleted ?? null;
+    }
+    // ─── Availability Overrides ─────────────────────────────────────────────────
+    async addOverride(providerId, data) {
+        const [row] = await this.db.insert(availabilityOverrides).values({
+            providerId,
+            date: data.date,
+            isAvailable: data.isAvailable,
+            startTime: data.startTime,
+            endTime: data.endTime,
+            reason: data.reason,
+        }).returning();
+        return row;
+    }
+    async getOverrides(providerId) {
+        return this.db.select().from(availabilityOverrides)
+            .where(eq(availabilityOverrides.providerId, providerId))
+            .orderBy(availabilityOverrides.date);
+    }
+    async deleteOverride(id) {
+        const [deleted] = await this.db.delete(availabilityOverrides)
+            .where(eq(availabilityOverrides.id, id)).returning();
+        return deleted ?? null;
+    }
+}

package/dist/services/slot-generation.d.ts

@@ -0,0 +1,15 @@
+import type { TimeSlot, SlotGenerationParams } from "../types.js";
+/**
+ * Pure function: generates available time slots for a given date.
+ *
+ * No DB access — all inputs passed as parameters.
+ * Handles: schedule hours, breaks, buffer time, existing bookings,
+ * min notice, max advance, and timezone conversion.
+ */
+export declare function generateSlots(params: SlotGenerationParams): TimeSlot[];
+/**
+ * Parses a time string (HH:mm) on a given date in a specific timezone,
+ * returning a UTC Date object.
+ */
+export declare function parseTimeInTimezone(date: Date, time: string, timezone: string): Date;
+//# sourceMappingURL=slot-generation.d.ts.map

package/dist/services/slot-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-generation.d.ts","sourceRoot":"","sources":["../../src/services/slot-generation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,EAAE,CAyEtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAmEpF"}

package/dist/services/slot-generation.js

@@ -0,0 +1,121 @@
+/**
+ * Pure function: generates available time slots for a given date.
+ *
+ * No DB access — all inputs passed as parameters.
+ * Handles: schedule hours, breaks, buffer time, existing bookings,
+ * min notice, max advance, and timezone conversion.
+ */
+export function generateSlots(params) {
+    const { date, schedule, durationMinutes, bufferBeforeMinutes = 0, bufferAfterMinutes = 0, breaks = [], existingBookings = [], minNoticeMinutes = 0, maxAdvanceDays = 0, timezone, now = new Date(), } = params;
+    // Day off — no slots
+    if (!schedule)
+        return [];
+    // Parse schedule times into absolute Date objects for the given date in the provider's timezone
+    const dayStart = parseTimeInTimezone(date, schedule.startTime, timezone);
+    const dayEnd = parseTimeInTimezone(date, schedule.endTime, timezone);
+    if (dayEnd <= dayStart)
+        return [];
+    // Generate candidate slots
+    const totalSlotMinutes = bufferBeforeMinutes + durationMinutes + bufferAfterMinutes;
+    const candidates = [];
+    let cursor = dayStart.getTime();
+    while (cursor + totalSlotMinutes * 60_000 <= dayEnd.getTime()) {
+        const slotStart = new Date(cursor + bufferBeforeMinutes * 60_000);
+        const slotEnd = new Date(slotStart.getTime() + durationMinutes * 60_000);
+        const blockEnd = new Date(slotEnd.getTime() + bufferAfterMinutes * 60_000);
+        candidates.push({ start: slotStart, end: slotEnd });
+        // Advance by duration + buffer after (so buffers don't overlap)
+        cursor = blockEnd.getTime();
+    }
+    // Filter out slots that overlap with breaks
+    const breakRanges = breaks.map((b) => ({
+        start: parseTimeInTimezone(date, b.startTime, timezone),
+        end: parseTimeInTimezone(date, b.endTime, timezone),
+    }));
+    let filtered = candidates.filter((slot) => {
+        // The slot's full block (including buffers) must not overlap any break
+        const blockStart = new Date(slot.start.getTime() - bufferBeforeMinutes * 60_000);
+        const blockEnd = new Date(slot.end.getTime() + bufferAfterMinutes * 60_000);
+        return !breakRanges.some((br) => blockStart < br.end && blockEnd > br.start);
+    });
+    // Filter out slots that overlap with existing bookings
+    filtered = filtered.filter((slot) => {
+        return !existingBookings.some((booking) => slot.start < booking.endTime && slot.end > booking.startTime);
+    });
+    // Filter out slots that violate min notice
+    if (minNoticeMinutes > 0) {
+        const earliestStart = new Date(now.getTime() + minNoticeMinutes * 60_000);
+        filtered = filtered.filter((slot) => slot.start >= earliestStart);
+    }
+    // Filter out slots that violate max advance
+    if (maxAdvanceDays > 0) {
+        const latestStart = new Date(now.getTime() + maxAdvanceDays * 24 * 60 * 60_000);
+        filtered = filtered.filter((slot) => slot.start <= latestStart);
+    }
+    return filtered;
+}
+/**
+ * Parses a time string (HH:mm) on a given date in a specific timezone,
+ * returning a UTC Date object.
+ */
+export function parseTimeInTimezone(date, time, timezone) {
+    const [hours, minutes] = time.split(":").map(Number);
+    // Build a date string in the target timezone
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    const h = String(hours).padStart(2, "0");
+    const m = String(minutes).padStart(2, "0");
+    // Create date in the provider's timezone using Intl
+    const dateStr = `${year}-${month}-${day}T${h}:${m}:00`;
+    // Use a formatter to figure out the UTC offset for this timezone at this date/time
+    const utcDate = new Date(dateStr + "Z");
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    });
+    // Find the offset by comparing what UTC time produces the desired local time
+    // Binary search-like approach: try the UTC date, see what local time it maps to,
+    // and adjust.
+    const parts = formatter.formatToParts(utcDate);
+    const localHour = Number(parts.find((p) => p.type === "hour")?.value ?? 0);
+    const localMinute = Number(parts.find((p) => p.type === "minute")?.value ?? 0);
+    const localDay = Number(parts.find((p) => p.type === "day")?.value ?? 0);
+    const localMonth = Number(parts.find((p) => p.type === "month")?.value ?? 0);
+    // Calculate the difference between the local time at UTC and our target
+    const targetMinutes = hours * 60 + minutes;
+    let localMinutes = localHour * 60 + localMinute;
+    // Handle day/month boundary crossings
+    const targetDay = date.getDate();
+    if (localDay !== targetDay || localMonth !== date.getMonth() + 1) {
+        // Day changed — adjust by a full day if needed
+        if (localDay > targetDay || localMonth > date.getMonth() + 1) {
+            localMinutes += 24 * 60; // local is ahead
+        }
+        else {
+            localMinutes -= 24 * 60; // local is behind
+        }
+    }
+    const offsetMinutes = localMinutes - targetMinutes;
+    // The UTC time = target time + offset (since local = UTC - offset means UTC = local + offset)
+    // Actually: if local shows 14:30 when UTC is 09:00, offset = +5:30
+    // We want UTC time that corresponds to target local time
+    // UTC = targetTime - offset... no: local = UTC + offset => UTC = local - offset
+    // offsetMinutes = local - target. If we set UTC = utcDate - offsetMinutes * 60000
+    // that gives us: local_of_result = (utcDate - offsetMinutes*60000) + offset
+    //              = utcDate + offset - offsetMinutes*60000
+    //              = utcDate + offset - (local - target)*60000
+    // Hmm, let me think differently.
+    //
+    // We know: formatter(utcDate) = localTime
+    // We want: formatter(result) = targetTime
+    // So: result = utcDate - (localTime - targetTime) * 60000
+    //            = utcDate - offsetMinutes * 60000
+    return new Date(utcDate.getTime() - offsetMinutes * 60_000);
+}

package/dist/services/slot-service.d.ts

@@ -0,0 +1,11 @@
+import type { Db, TimeSlot } from "../types.js";
+export declare class SlotService {
+    private db;
+    private defaults;
+    constructor(db: Db, defaults?: {
+        minNoticeMinutes: number;
+        maxAdvanceDays: number;
+    });
+    getAvailableSlots(providerId: string, serviceTypeId: string, date: Date, durationMinutes: number, bufferBeforeMinutes: number, bufferAfterMinutes: number, timezone: string, now?: Date): Promise<TimeSlot[]>;
+}
+//# sourceMappingURL=slot-service.d.ts.map

package/dist/services/slot-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-service.d.ts","sourceRoot":"","sources":["../../src/services/slot-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAA6C,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3F,qBAAa,WAAW;IAEpB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ;gBADR,EAAE,EAAE,EAAE,EACN,QAAQ,GAAE;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACsB;IAG3C,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,MAAM,EAC3B,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,QAAQ,EAAE,CAAC;CAiGvB"}