@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/invoice/invoice-create.d.ts

@@ -0,0 +1,367 @@
+/**
+ * invoice_create Tool
+ *
+ * Create a new invoice in FreshBooks.
+ */
+import { z } from 'zod';
+import { InvoiceCreateInputSchema, InvoiceSingleOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for invoice_create
+ */
+export declare const invoiceCreateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        customerId: z.ZodNumber;
+        createDate: z.ZodOptional<z.ZodString>;
+        dueDate: z.ZodOptional<z.ZodString>;
+        currencyCode: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        lines: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            qty: z.ZodDefault<z.ZodNumber>;
+            unitCost: z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                amount: string;
+                code?: string | undefined;
+            }, {
+                amount: string;
+                code?: string | undefined;
+            }>;
+            taxName1: z.ZodOptional<z.ZodString>;
+            taxAmount1: z.ZodOptional<z.ZodString>;
+            taxName2: z.ZodOptional<z.ZodString>;
+            taxAmount2: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            qty: number;
+            unitCost: {
+                amount: string;
+                code?: string | undefined;
+            };
+            description?: string | undefined;
+            taxName1?: string | undefined;
+            taxAmount1?: string | undefined;
+            taxName2?: string | undefined;
+            taxAmount2?: string | undefined;
+        }, {
+            name: string;
+            unitCost: {
+                amount: string;
+                code?: string | undefined;
+            };
+            description?: string | undefined;
+            qty?: number | undefined;
+            taxName1?: string | undefined;
+            taxAmount1?: string | undefined;
+            taxName2?: string | undefined;
+            taxAmount2?: string | undefined;
+        }>, "many">;
+        notes: z.ZodOptional<z.ZodString>;
+        terms: z.ZodOptional<z.ZodString>;
+        discount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            amount: string;
+            code?: string | undefined;
+        }, {
+            amount: string;
+            code?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        lines: {
+            name: string;
+            qty: number;
+            unitCost: {
+                amount: string;
+                code?: string | undefined;
+            };
+            description?: string | undefined;
+            taxName1?: string | undefined;
+            taxAmount1?: string | undefined;
+            taxName2?: string | undefined;
+            taxAmount2?: string | undefined;
+        }[];
+        customerId: number;
+        dueDate?: string | undefined;
+        currencyCode?: string | undefined;
+        createDate?: string | undefined;
+        notes?: string | undefined;
+        terms?: string | undefined;
+        discount?: {
+            amount: string;
+            code?: string | undefined;
+        } | undefined;
+    }, {
+        accountId: string;
+        lines: {
+            name: string;
+            unitCost: {
+                amount: string;
+                code?: string | undefined;
+            };
+            description?: string | undefined;
+            qty?: number | undefined;
+            taxName1?: string | undefined;
+            taxAmount1?: string | undefined;
+            taxName2?: string | undefined;
+            taxAmount2?: string | undefined;
+        }[];
+        customerId: number;
+        dueDate?: string | undefined;
+        currencyCode?: string | undefined;
+        createDate?: string | undefined;
+        notes?: string | undefined;
+        terms?: string | undefined;
+        discount?: {
+            amount: string;
+            code?: string | undefined;
+        } | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        invoiceNumber: z.ZodString;
+        customerId: z.ZodNumber;
+        createDate: z.ZodString;
+        dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        outstanding: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        paid: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        status: z.ZodEnum<["draft", "sent", "viewed", "partial", "paid", "auto_paid", "retry", "failed", "overdue", "disputed"]>;
+        paymentStatus: z.ZodEnum<["unpaid", "partial", "paid", "auto_paid"]>;
+        currencyCode: z.ZodString;
+        lines: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            qty: z.ZodNumber;
+            amount: z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>;
+            taxName1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            taxAmount1: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>>;
+            taxName2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            taxAmount2: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            qty: number;
+            description?: string | undefined;
+            taxName1?: string | null | undefined;
+            taxAmount1?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+            taxName2?: string | null | undefined;
+            taxAmount2?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+        }, {
+            name: string;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            qty: number;
+            description?: string | undefined;
+            taxName1?: string | null | undefined;
+            taxAmount1?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+            taxName2?: string | null | undefined;
+            taxAmount2?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+        }>, "many">;
+        notes: z.ZodOptional<z.ZodString>;
+        terms: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        organization: z.ZodOptional<z.ZodString>;
+        fName: z.ZodOptional<z.ZodString>;
+        lName: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        province: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "partial" | "failed" | "draft" | "sent" | "viewed" | "paid" | "auto_paid" | "retry" | "overdue" | "disputed";
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        currencyCode: string;
+        outstanding: {
+            code: string;
+            amount: string;
+        };
+        lines: {
+            name: string;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            qty: number;
+            description?: string | undefined;
+            taxName1?: string | null | undefined;
+            taxAmount1?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+            taxName2?: string | null | undefined;
+            taxAmount2?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+        }[];
+        paid: {
+            code: string;
+            amount: string;
+        };
+        invoiceNumber: string;
+        customerId: number;
+        createDate: string;
+        paymentStatus: "partial" | "paid" | "auto_paid" | "unpaid";
+        code?: string | undefined;
+        email?: string | undefined;
+        createdAt?: string | undefined;
+        dueDate?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | null | undefined;
+        organization?: string | undefined;
+        fName?: string | undefined;
+        lName?: string | undefined;
+        notes?: string | undefined;
+        terms?: string | null | undefined;
+        address?: string | undefined;
+        city?: string | undefined;
+        province?: string | undefined;
+        country?: string | undefined;
+    }, {
+        status: "partial" | "failed" | "draft" | "sent" | "viewed" | "paid" | "auto_paid" | "retry" | "overdue" | "disputed";
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        currencyCode: string;
+        outstanding: {
+            code: string;
+            amount: string;
+        };
+        lines: {
+            name: string;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            qty: number;
+            description?: string | undefined;
+            taxName1?: string | null | undefined;
+            taxAmount1?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+            taxName2?: string | null | undefined;
+            taxAmount2?: {
+                code: string;
+                amount: string;
+            } | null | undefined;
+        }[];
+        paid: {
+            code: string;
+            amount: string;
+        };
+        invoiceNumber: string;
+        customerId: number;
+        createDate: string;
+        paymentStatus: "partial" | "paid" | "auto_paid" | "unpaid";
+        code?: string | undefined;
+        email?: string | undefined;
+        createdAt?: string | undefined;
+        dueDate?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | null | undefined;
+        organization?: string | undefined;
+        fName?: string | undefined;
+        lName?: string | undefined;
+        notes?: string | undefined;
+        terms?: string | null | undefined;
+        address?: string | undefined;
+        city?: string | undefined;
+        province?: string | undefined;
+        country?: string | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof InvoiceCreateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof InvoiceSingleOutputSchema>>;
+};
+//# sourceMappingURL=invoice-create.d.ts.map

package/dist/tools/invoice/invoice-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-create.d.ts","sourceRoot":"","sources":["../../../src/tools/invoice/invoice-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6C5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CA2EtD,CAAC"}

package/dist/tools/invoice/invoice-create.js

@@ -0,0 +1,115 @@
+/**
+ * invoice_create Tool
+ *
+ * Create a new invoice in FreshBooks.
+ */
+import { InvoiceCreateInputSchema, InvoiceSingleOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for invoice_create
+ */
+export const invoiceCreateTool = {
+    name: 'invoice_create',
+    description: `Create a new invoice in FreshBooks.
+
+WHEN TO USE:
+- User wants to create a new invoice
+- User says "create invoice", "bill client", "new invoice"
+- After completing work that needs to be billed
+- Setting up recurring billing for a client
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- customerId: Client ID (use client_list to find)
+- lines: At least one line item with name, quantity, and unit cost
+
+LINE ITEMS:
+Each line must have:
+- name: Description of service/product
+- qty: Quantity (default: 1)
+- unitCost: { amount: "100.00", code: "USD" }
+
+Optional per line:
+- description: Additional details
+- taxName1, taxAmount1: First tax
+- taxName2, taxAmount2: Second tax
+
+OPTIONAL:
+- createDate: Invoice date (YYYY-MM-DD, defaults to today)
+- dueDate: Payment due date (YYYY-MM-DD)
+- currencyCode: Currency (default: USD)
+- notes: Notes to appear on invoice
+- terms: Payment terms
+- discount: { amount: "10.00" } or percentage
+
+RETURNS:
+Created invoice with assigned ID, calculated totals, and status.
+
+EXAMPLES:
+- "Create an invoice for client 123 for $500 consulting"
+- "Bill client 456 for 10 hours at $150/hour"
+- "New invoice with two line items"`,
+    inputSchema: InvoiceCreateInputSchema,
+    outputSchema: InvoiceSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('invoice_create', async (input, _context) => {
+            const { accountId, ...invoiceData } = input;
+            logger.debug('Creating invoice', {
+                accountId,
+                customerId: invoiceData.customerId,
+                lineCount: invoiceData.lines.length,
+            });
+            // Build invoice payload using camelCase properties
+            // The FreshBooks SDK's transformInvoiceRequest() will convert to API format
+            const invoicePayload = {
+                customerId: invoiceData.customerId,
+                createDate: invoiceData.createDate || new Date().toISOString().split('T')[0],
+                currencyCode: invoiceData.currencyCode || 'USD',
+                lines: invoiceData.lines.map((line) => ({
+                    name: line.name,
+                    description: line.description || '',
+                    qty: line.qty || 1,
+                    unitCost: {
+                        amount: line.unitCost.amount,
+                        code: line.unitCost.code || invoiceData.currencyCode || 'USD',
+                    },
+                    taxName1: line.taxName1 || null,
+                    taxAmount1: line.taxAmount1 || null,
+                    taxName2: line.taxName2 || null,
+                    taxAmount2: line.taxAmount2 || null,
+                })),
+            };
+            if (invoiceData.dueDate) {
+                invoicePayload.dueDate = invoiceData.dueDate;
+            }
+            if (invoiceData.notes) {
+                invoicePayload.notes = invoiceData.notes;
+            }
+            if (invoiceData.terms) {
+                invoicePayload.terms = invoiceData.terms;
+            }
+            if (invoiceData.discount) {
+                invoicePayload.discountValue = invoiceData.discount.amount;
+            }
+            const result = await client.executeWithRetry('invoice_create', async (fbClient) => {
+                const response = await fbClient.invoices.create(invoicePayload, accountId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { invoice: { ... } }
+            const createdInvoice = result.invoice ?? result;
+            logger.info('Invoice created successfully', {
+                invoiceId: createdInvoice.id,
+            });
+            return createdInvoice;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=invoice-create.js.map

package/dist/tools/invoice/invoice-create.js.map

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

package/dist/tools/invoice/invoice-delete.d.ts

@@ -0,0 +1,40 @@
+/**
+ * invoice_delete Tool
+ *
+ * Delete an invoice from FreshBooks.
+ */
+import { z } from 'zod';
+import { InvoiceDeleteInputSchema, InvoiceDeleteOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for invoice_delete
+ */
+export declare const invoiceDeleteTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        invoiceId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        invoiceId: number;
+    }, {
+        accountId: string;
+        invoiceId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        invoiceId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        invoiceId: number;
+    }, {
+        success: boolean;
+        invoiceId: number;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof InvoiceDeleteInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof InvoiceDeleteOutputSchema>>;
+};
+//# sourceMappingURL=invoice-delete.d.ts.map

package/dist/tools/invoice/invoice-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/invoice/invoice-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;IAqC5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAwCtD,CAAC"}

package/dist/tools/invoice/invoice-delete.js

@@ -0,0 +1,75 @@
+/**
+ * invoice_delete Tool
+ *
+ * Delete an invoice from FreshBooks.
+ */
+import { InvoiceDeleteInputSchema, InvoiceDeleteOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for invoice_delete
+ */
+export const invoiceDeleteTool = {
+    name: 'invoice_delete',
+    description: `Delete an invoice from FreshBooks.
+
+WHEN TO USE:
+- User wants to remove an invoice
+- User says "delete invoice", "remove invoice", "delete invoice ID 123"
+- Cleaning up duplicate or test invoices
+- Removing draft invoices that won't be sent
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- invoiceId: The invoice ID to delete (numeric)
+
+IMPORTANT NOTES:
+- This performs a soft delete (sets visState to deleted)
+- Invoice data is preserved for accounting records
+- Payment history remains intact
+- Deleted invoices can potentially be restored
+- Cannot delete invoices with payments - void them instead
+
+ALTERNATIVE:
+Instead of deletion, consider:
+- Setting status to 'draft' to unpublish
+- Voiding the invoice for accounting purposes
+
+RETURNS:
+Confirmation with success status and deleted invoice ID.
+
+EXAMPLES:
+- "Delete invoice 123"
+- "Remove invoice ID 456"
+- "Delete the draft invoice"`,
+    inputSchema: InvoiceDeleteInputSchema,
+    outputSchema: InvoiceDeleteOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('invoice_delete', async (input, _context) => {
+            const { accountId, invoiceId } = input;
+            logger.debug('Deleting invoice', {
+                accountId,
+                invoiceId,
+            });
+            await client.executeWithRetry('invoice_delete', async (fbClient) => {
+                const response = await fbClient.invoices.delete(accountId, String(invoiceId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            logger.info('Invoice deleted successfully', {
+                invoiceId,
+            });
+            return {
+                success: true,
+                invoiceId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=invoice-delete.js.map

package/dist/tools/invoice/invoice-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-delete.js","sourceRoot":"","sources":["../../../src/tools/invoice/invoice-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA8Bc;IAE3B,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IAEvC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA+C,EAC/C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,gBAAgB,EAChB,KAAK,EACH,KAA+C,EAC/C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;YAEvC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;gBAC/B,SAAS;gBACT,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAC3B,gBAAgB,EAChB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;gBAE9E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS;aACV,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}