@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/project/project-list.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Project List Tool
+ *
+ * List projects with pagination and optional filtering.
+ */
+import { z } from "zod";
+import { ProjectListInputSchema, ProjectListOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/freshbooks-client.js";
+/**
+ * Tool definition for project_list
+ */
+export declare const projectListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        clientId: z.ZodOptional<z.ZodString>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        complete: z.ZodOptional<z.ZodBoolean>;
+        internal: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+    } & {
+        sortBy: z.ZodOptional<z.ZodEnum<["title" | "created_at" | "due_date", ...("title" | "created_at" | "due_date")[]]>>;
+        sortOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["asc", "desc"]>>>;
+    } & {
+        include: z.ZodOptional<z.ZodArray<z.ZodEnum<["client" | "services" | "group", ...("client" | "services" | "group")[]]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        title?: string | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sortBy?: "title" | "created_at" | "due_date" | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        include?: ("client" | "services" | "group")[] | undefined;
+        clientId?: string | undefined;
+        active?: boolean | undefined;
+        internal?: boolean | undefined;
+        complete?: boolean | undefined;
+    }, {
+        businessId: number;
+        title?: string | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sortBy?: "title" | "created_at" | "due_date" | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        include?: ("client" | "services" | "group")[] | undefined;
+        clientId?: string | undefined;
+        active?: boolean | undefined;
+        internal?: boolean | undefined;
+        complete?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        projects: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            title: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            dueDate: z.ZodNullable<z.ZodString>;
+            clientId: z.ZodNullable<z.ZodString>;
+            internal: z.ZodBoolean;
+            budget: z.ZodNullable<z.ZodString>;
+            fixedPrice: z.ZodNullable<z.ZodString>;
+            rate: z.ZodNullable<z.ZodString>;
+            billingMethod: z.ZodNullable<z.ZodEnum<["project_rate", "service_rate", "flat_rate", "team_member_rate"]>>;
+            projectType: z.ZodEnum<["fixed_price", "hourly_rate"]>;
+            projectManagerId: z.ZodNullable<z.ZodString>;
+            active: z.ZodBoolean;
+            complete: z.ZodBoolean;
+            sample: z.ZodBoolean;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            loggedDuration: z.ZodNullable<z.ZodNumber>;
+            services: z.ZodNullable<z.ZodArray<z.ZodAny, "many">>;
+            billedAmount: z.ZodNumber;
+            billedStatus: z.ZodEnum<["unbilled", "partial", "billed"]>;
+            retainerId: z.ZodNullable<z.ZodString>;
+            expenseMarkup: z.ZodNumber;
+            groupId: z.ZodNullable<z.ZodString>;
+            group: z.ZodNullable<z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            description: string | null;
+            title: string;
+            createdAt: string;
+            id: number;
+            clientId: string | null;
+            active: boolean;
+            internal: boolean;
+            retainerId: string | null;
+            services: any[] | null;
+            dueDate: string | null;
+            budget: string | null;
+            fixedPrice: string | null;
+            rate: string | null;
+            billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+            projectType: "fixed_price" | "hourly_rate";
+            projectManagerId: string | null;
+            complete: boolean;
+            sample: boolean;
+            updatedAt: string;
+            loggedDuration: number | null;
+            billedAmount: number;
+            billedStatus: "unbilled" | "partial" | "billed";
+            expenseMarkup: number;
+            groupId: string | null;
+            group?: any;
+        }, {
+            description: string | null;
+            title: string;
+            createdAt: string;
+            id: number;
+            clientId: string | null;
+            active: boolean;
+            internal: boolean;
+            retainerId: string | null;
+            services: any[] | null;
+            dueDate: string | null;
+            budget: string | null;
+            fixedPrice: string | null;
+            rate: string | null;
+            billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+            projectType: "fixed_price" | "hourly_rate";
+            projectManagerId: string | null;
+            complete: boolean;
+            sample: boolean;
+            updatedAt: string;
+            loggedDuration: number | null;
+            billedAmount: number;
+            billedStatus: "unbilled" | "partial" | "billed";
+            expenseMarkup: number;
+            groupId: string | null;
+            group?: any;
+        }>, "many">;
+        pagination: z.ZodObject<{
+            page: z.ZodNumber;
+            pages: z.ZodNumber;
+            perPage: z.ZodNumber;
+            total: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        projects: {
+            description: string | null;
+            title: string;
+            createdAt: string;
+            id: number;
+            clientId: string | null;
+            active: boolean;
+            internal: boolean;
+            retainerId: string | null;
+            services: any[] | null;
+            dueDate: string | null;
+            budget: string | null;
+            fixedPrice: string | null;
+            rate: string | null;
+            billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+            projectType: "fixed_price" | "hourly_rate";
+            projectManagerId: string | null;
+            complete: boolean;
+            sample: boolean;
+            updatedAt: string;
+            loggedDuration: number | null;
+            billedAmount: number;
+            billedStatus: "unbilled" | "partial" | "billed";
+            expenseMarkup: number;
+            groupId: string | null;
+            group?: any;
+        }[];
+    }, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        projects: {
+            description: string | null;
+            title: string;
+            createdAt: string;
+            id: number;
+            clientId: string | null;
+            active: boolean;
+            internal: boolean;
+            retainerId: string | null;
+            services: any[] | null;
+            dueDate: string | null;
+            budget: string | null;
+            fixedPrice: string | null;
+            rate: string | null;
+            billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+            projectType: "fixed_price" | "hourly_rate";
+            projectManagerId: string | null;
+            complete: boolean;
+            sample: boolean;
+            updatedAt: string;
+            loggedDuration: number | null;
+            billedAmount: number;
+            billedStatus: "unbilled" | "partial" | "billed";
+            expenseMarkup: number;
+            groupId: string | null;
+            group?: any;
+        }[];
+    }>;
+    execute(input: z.infer<typeof ProjectListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ProjectListOutputSchema>>;
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export declare function handleProjectList(input: z.infer<typeof ProjectListInputSchema>, context: {
+    client: FreshBooksClientWrapper;
+}): Promise<z.infer<typeof ProjectListOutputSchema>>;
+//# sourceMappingURL=project-list.d.ts.map

package/dist/tools/project/project-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.d.ts","sourceRoot":"","sources":["../../../src/tools/project/project-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA8CjB,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,UACrC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;CAqEpD,CAAC;AAEF;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC7C,OAAO,EAAE;IAAE,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC3C,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAElD"}

package/dist/tools/project/project-list.js

@@ -0,0 +1,118 @@
+/**
+ * Project List Tool
+ *
+ * List projects with pagination and optional filtering.
+ */
+import { ProjectListInputSchema, ProjectListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { buildQueryBuilders } from "../base-tool.js";
+/**
+ * Tool definition for project_list
+ */
+export const projectListTool = {
+    name: "project_list",
+    description: `List projects from FreshBooks with optional filtering and pagination.
+
+WHEN TO USE:
+- User asks to "see projects", "list projects", "show all projects"
+- User wants to find a project by name or client
+- User needs project information for time tracking context
+
+FILTERING OPTIONS:
+- clientId: Filter by specific client
+- active: Show only active/inactive projects
+- complete: Show only complete/incomplete projects
+- internal: Show only internal/billable projects
+- title: Search by project name (partial match)
+
+SORTING:
+- sortBy: Field to sort by (title, created_at, due_date)
+- sortOrder: Sort direction (asc or desc, default: desc)
+
+INCLUDES:
+- include: Related data to fetch (client, services, group)
+  - client: Client details associated with the project
+  - services: Service/billing rate configurations
+  - group: Project group for organization
+
+PAGINATION:
+- Use page/perPage for large result sets
+- Default: 30 results per page
+- Maximum: 100 results per page
+
+EXAMPLE PROMPTS:
+- "Show me all active projects"
+- "List projects for client ABC123"
+- "Find projects with 'Website' in the title"
+- "Show incomplete projects sorted by due date"
+- "Get projects with client details included"
+
+RETURNS:
+Array of projects with titles, clients, billing info, and time logged.
+Includes pagination metadata for navigating large result sets.`,
+    inputSchema: ProjectListInputSchema,
+    outputSchema: ProjectListOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler("project_list", async (input, _context) => {
+            const { businessId, page, perPage, sortBy, sortOrder, include, ...filters } = input;
+            // Execute the API call
+            const result = await client.executeWithRetry("project_list", async (fbClient) => {
+                // Build query builders using the helper
+                const queryBuilders = await buildQueryBuilders({
+                    page,
+                    perPage,
+                    sortBy,
+                    sortOrder,
+                    include,
+                    searchFilters: (search) => {
+                        if (filters.clientId !== undefined) {
+                            search.equals("client_id", filters.clientId);
+                        }
+                        if (filters.active !== undefined) {
+                            search.boolean("active", filters.active);
+                        }
+                        if (filters.complete !== undefined) {
+                            search.boolean("complete", filters.complete);
+                        }
+                        if (filters.internal !== undefined) {
+                            search.boolean("internal", filters.internal);
+                        }
+                        if (filters.title !== undefined) {
+                            search.like("title", filters.title);
+                        }
+                    },
+                });
+                const response = await fbClient.projects.list(businessId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data
+            const projects = result.projects || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: projects.length,
+                per_page: 30,
+            };
+            return {
+                projects,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export async function handleProjectList(input, context) {
+    return projectListTool.execute(input, context.client);
+}
+//# sourceMappingURL=project-list.js.map

package/dist/tools/project/project-list.js.map

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

package/dist/tools/project/project-single.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Project Single Tool
+ *
+ * Get detailed information about a specific project by ID.
+ */
+import { z } from "zod";
+import { ProjectSingleInputSchema, ProjectSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/freshbooks-client.js";
+/**
+ * Tool definition for project_single
+ */
+export declare const projectSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        projectId: z.ZodNumber;
+        includes: z.ZodOptional<z.ZodArray<z.ZodEnum<["client", "services", "group"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        projectId: number;
+        includes?: ("client" | "services" | "group")[] | undefined;
+    }, {
+        businessId: number;
+        projectId: number;
+        includes?: ("client" | "services" | "group")[] | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        title: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        dueDate: z.ZodNullable<z.ZodString>;
+        clientId: z.ZodNullable<z.ZodString>;
+        internal: z.ZodBoolean;
+        budget: z.ZodNullable<z.ZodString>;
+        fixedPrice: z.ZodNullable<z.ZodString>;
+        rate: z.ZodNullable<z.ZodString>;
+        billingMethod: z.ZodNullable<z.ZodEnum<["project_rate", "service_rate", "flat_rate", "team_member_rate"]>>;
+        projectType: z.ZodEnum<["fixed_price", "hourly_rate"]>;
+        projectManagerId: z.ZodNullable<z.ZodString>;
+        active: z.ZodBoolean;
+        complete: z.ZodBoolean;
+        sample: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        loggedDuration: z.ZodNullable<z.ZodNumber>;
+        services: z.ZodNullable<z.ZodArray<z.ZodAny, "many">>;
+        billedAmount: z.ZodNumber;
+        billedStatus: z.ZodEnum<["unbilled", "partial", "billed"]>;
+        retainerId: z.ZodNullable<z.ZodString>;
+        expenseMarkup: z.ZodNumber;
+        groupId: z.ZodNullable<z.ZodString>;
+        group: z.ZodNullable<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        description: string | null;
+        title: string;
+        createdAt: string;
+        id: number;
+        clientId: string | null;
+        active: boolean;
+        internal: boolean;
+        retainerId: string | null;
+        services: any[] | null;
+        dueDate: string | null;
+        budget: string | null;
+        fixedPrice: string | null;
+        rate: string | null;
+        billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+        projectType: "fixed_price" | "hourly_rate";
+        projectManagerId: string | null;
+        complete: boolean;
+        sample: boolean;
+        updatedAt: string;
+        loggedDuration: number | null;
+        billedAmount: number;
+        billedStatus: "unbilled" | "partial" | "billed";
+        expenseMarkup: number;
+        groupId: string | null;
+        group?: any;
+    }, {
+        description: string | null;
+        title: string;
+        createdAt: string;
+        id: number;
+        clientId: string | null;
+        active: boolean;
+        internal: boolean;
+        retainerId: string | null;
+        services: any[] | null;
+        dueDate: string | null;
+        budget: string | null;
+        fixedPrice: string | null;
+        rate: string | null;
+        billingMethod: "project_rate" | "service_rate" | "flat_rate" | "team_member_rate" | null;
+        projectType: "fixed_price" | "hourly_rate";
+        projectManagerId: string | null;
+        complete: boolean;
+        sample: boolean;
+        updatedAt: string;
+        loggedDuration: number | null;
+        billedAmount: number;
+        billedStatus: "unbilled" | "partial" | "billed";
+        expenseMarkup: number;
+        groupId: string | null;
+        group?: any;
+    }>;
+    execute(input: z.infer<typeof ProjectSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ProjectSingleOutputSchema>>;
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export declare function handleProjectSingle(input: z.infer<typeof ProjectSingleInputSchema>, context: {
+    client: FreshBooksClientWrapper;
+}): Promise<z.infer<typeof ProjectSingleOutputSchema>>;
+//# sourceMappingURL=project-single.d.ts.map

package/dist/tools/project/project-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-single.d.ts","sourceRoot":"","sources":["../../../src/tools/project/project-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA+BnB,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CA6BtD,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAC/C,OAAO,EAAE;IAAE,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC3C,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAEpD"}

package/dist/tools/project/project-single.js

@@ -0,0 +1,63 @@
+/**
+ * Project Single Tool
+ *
+ * Get detailed information about a specific project by ID.
+ */
+import { ProjectSingleInputSchema, ProjectSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for project_single
+ */
+export const projectSingleTool = {
+    name: "project_single",
+    description: `Get detailed information about a specific project by ID.
+
+WHEN TO USE:
+- User asks for details about a specific project
+- User provides a project ID or name from a previous list
+- Need full project information including rates and billing settings
+
+REQUIRED INFO:
+- Project ID (numeric)
+- Account ID (get from context or user)
+
+OPTIONAL INCLUDES:
+- client: Include full client details
+- services: Include associated service definitions
+- group: Include project group information
+
+EXAMPLE PROMPTS:
+- "Show me details for project 12345"
+- "Get information about the Website Redesign project"
+- "What's the billing method for project 98765?"
+
+RETURNS:
+Complete project details including title, description, client, billing method,
+rates, time logged, completion status, and financial totals.`,
+    inputSchema: ProjectSingleInputSchema,
+    outputSchema: ProjectSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler("project_single", async (input, _context) => {
+            const { businessId, projectId } = input;
+            // Execute the API call
+            const result = await client.executeWithRetry("project_single", async (fbClient) => {
+                const response = await fbClient.projects.single(businessId, projectId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { project: { ... } }
+            const project = result.project ?? result;
+            return project;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export async function handleProjectSingle(input, context) {
+    return projectSingleTool.execute(input, context.client);
+}
+//# sourceMappingURL=project-single.js.map

package/dist/tools/project/project-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-single.js","sourceRoot":"","sources":["../../../src/tools/project/project-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;6DAuB8C;IAE3D,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IAEvC,KAAK,CAAC,OAAO,CACX,KAA+C,EAC/C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,gBAAgB,EAChB,KAAK,EAAE,KAA+C,EAAE,QAAqB,EAAE,EAAE;YAC/E,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;YAExC,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,gBAAgB,EAChB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBAEvE,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,2CAA2C;YAC3C,MAAM,OAAO,GAAI,MAAgC,CAAC,OAAO,IAAI,MAAM,CAAC;YAEpE,OAAO,OAAoD,CAAC;QAC9D,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA+C,EAC/C,OAA4C;IAE5C,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC"}