mcp-quickbase 2.1.0 → 2.2.0

package/dist/tools/apps/list_tables.d.ts

@@ -42,15 +42,15 @@ export interface TableInfo {
  */
 export interface ListTablesParams {
     /**
-     * The ID of the application (optional, uses the configured one if not provided)
+     * The application ID to list tables for
      */
     app_id?: string;
     /**
-     * Whether to include hidden tables in the results
+     * Whether to include hidden tables
      */
     include_hidden?: boolean;
     /**
-     * Filter tables by pattern (case-insensitive substring match)
+     * Filter tables by name (case-insensitive substring match)
      */
     filter?: string;
 }
@@ -59,7 +59,7 @@ export interface ListTablesParams {
  */
 export interface ListTablesResult {
     /**
-     * Array of table information
+     * Array of tables in the application
      */
     tables: TableInfo[];
     /**
@@ -68,7 +68,7 @@ export interface ListTablesResult {
     appId: string;
 }
 /**
- * Tool for listing tables in a Quickbase application
+ * Tool for listing all tables in a Quickbase application
  */
 export declare class ListTablesTool extends BaseTool<ListTablesParams, ListTablesResult> {
     name: string;

package/dist/tools/apps/list_tables.js

@@ -5,7 +5,7 @@ const base_1 = require("../base");
 const logger_1 = require("../../utils/logger");
 const logger = (0, logger_1.createLogger)("ListTablesTool");
 /**
- * Tool for listing tables in a Quickbase application
+ * Tool for listing all tables in a Quickbase application
  */
 class ListTablesTool extends base_1.BaseTool {
     /**

package/dist/tools/index.d.ts

@@ -16,3 +16,4 @@ export * from "./fields";
 export * from "./records";
 export * from "./files";
 export * from "./reports";
+export * from "./relationships";

package/dist/tools/index.js

@@ -24,6 +24,7 @@ const fields_1 = require("./fields");
 const records_1 = require("./records");
 const files_1 = require("./files");
 const reports_1 = require("./reports");
+const relationships_1 = require("./relationships");
 const logger_1 = require("../utils/logger");
 const logger = (0, logger_1.createLogger)("ToolsInit");
 /**
@@ -48,7 +49,8 @@ function initializeTools(client, cacheService) {
     (0, files_1.registerFileTools)(client);
     // Register report operation tools
     (0, reports_1.registerReportTools)(client);
-    // Additional tools will be registered here
+    // Register relationship management tools
+    (0, relationships_1.registerRelationshipTools)(client);
     logger.info(`Registered ${registry_1.toolRegistry.getToolCount()} tools`);
 }
 // Export all tools and related types
@@ -62,4 +64,5 @@ __exportStar(require("./fields"), exports);
 __exportStar(require("./records"), exports);
 __exportStar(require("./files"), exports);
 __exportStar(require("./reports"), exports);
+__exportStar(require("./relationships"), exports);
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAoBA,0CA+BC;AAjDD,yCAA0C;AAC1C,uDAAuD;AACvD,uDAAuD;AACvD,iCAA0C;AAC1C,qCAA8C;AAC9C,qCAA8C;AAC9C,uCAAgD;AAChD,mCAA4C;AAC5C,uCAAgD;AAChD,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,WAAW,CAAC,CAAC;AAEzC;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,MAAuB,EACvB,YAA0B;IAE1B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAEtC,4BAA4B;IAC5B,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAExE,gCAAgC;IAChC,IAAA,uBAAgB,EAAC,MAAM,CAAC,CAAC;IAEzB,iCAAiC;IACjC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,gCAAgC;IAChC,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IAE1B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,2CAA2C;IAE3C,MAAM,CAAC,IAAI,CAAC,cAAc,uBAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,qCAAqC;AACrC,6CAA2B;AAC3B,yCAAuB;AACvB,oDAAkC;AAClC,oDAAkC;AAClC,yCAAuB;AACvB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAqBA,0CAgCC;AAnDD,yCAA0C;AAC1C,uDAAuD;AACvD,uDAAuD;AACvD,iCAA0C;AAC1C,qCAA8C;AAC9C,qCAA8C;AAC9C,uCAAgD;AAChD,mCAA4C;AAC5C,uCAAgD;AAChD,mDAA4D;AAC5D,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,WAAW,CAAC,CAAC;AAEzC;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,MAAuB,EACvB,YAA0B;IAE1B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAEtC,4BAA4B;IAC5B,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,uBAAY,CAAC,YAAY,CAAC,IAAI,oCAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAExE,gCAAgC;IAChC,IAAA,uBAAgB,EAAC,MAAM,CAAC,CAAC;IAEzB,iCAAiC;IACjC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,2BAAkB,EAAC,MAAM,CAAC,CAAC;IAE3B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,gCAAgC;IAChC,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IAE1B,kCAAkC;IAClC,IAAA,6BAAmB,EAAC,MAAM,CAAC,CAAC;IAE5B,yCAAyC;IACzC,IAAA,yCAAyB,EAAC,MAAM,CAAC,CAAC;IAElC,MAAM,CAAC,IAAI,CAAC,cAAc,uBAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,qCAAqC;AACrC,6CAA2B;AAC3B,yCAAuB;AACvB,oDAAkC;AAClC,oDAAkC;AAClC,yCAAuB;AACvB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,kDAAgC"}

package/dist/tools/relationships/create_relationship.d.ts

@@ -0,0 +1,150 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+import { RelationshipFieldInfo } from "./get_relationships";
+/**
+ * Valid accumulation types for summary fields
+ */
+export type SummaryAccumulationType = "SUM" | "COUNT" | "AVG" | "MAX" | "MIN";
+/**
+ * Parameters for create_relationship tool
+ */
+export interface CreateRelationshipParams {
+    /**
+     * The ID of the child table (DBID) where the relationship reference field will be created
+     */
+    table_id: string;
+    /**
+     * The ID of the parent table (DBID) to link to
+     */
+    parent_table_id: string;
+    /**
+     * Optional label for the foreign key reference field created in the child table
+     */
+    foreign_key_label?: string;
+    /**
+     * Optional array of parent field IDs to create as lookup fields in the child table
+     */
+    lookup_field_ids?: number[];
+    /**
+     * Optional child field ID to summarize in the parent table
+     */
+    summary_field_id?: number;
+    /**
+     * Optional label for the summary field created in the parent table
+     */
+    summary_label?: string;
+    /**
+     * Accumulation type for the summary field (required if summary_field_id is provided)
+     */
+    summary_accumulation_type?: SummaryAccumulationType;
+    /**
+     * Optional Quickbase query filter for the summary field
+     */
+    summary_where?: string;
+}
+/**
+ * Result from creating a relationship
+ */
+export interface CreateRelationshipResult {
+    /**
+     * The ID of the relationship (same as the foreign key field ID)
+     */
+    id: number;
+    /**
+     * The ID of the parent table
+     */
+    parentTableId: string;
+    /**
+     * The ID of the child table
+     */
+    childTableId: string;
+    /**
+     * The foreign key field created in the child table
+     */
+    foreignKeyField: RelationshipFieldInfo;
+    /**
+     * Lookup fields created in the child table
+     */
+    lookupFields: RelationshipFieldInfo[];
+    /**
+     * Summary fields created in the parent table
+     */
+    summaryFields: RelationshipFieldInfo[];
+}
+/**
+ * Tool for creating a new table-to-table relationship in Quickbase.
+ *
+ * Creates a reference field in the child table linking to the parent table.
+ * Optionally creates lookup fields and/or summary fields.
+ */
+export declare class CreateRelationshipTool extends BaseTool<CreateRelationshipParams, CreateRelationshipResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for create_relationship with conditional validation
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            parent_table_id: {
+                type: string;
+                description: string;
+            };
+            foreign_key_label: {
+                type: string;
+                description: string;
+            };
+            lookup_field_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            summary_field_id: {
+                type: string;
+                description: string;
+            };
+            summary_label: {
+                type: string;
+                description: string;
+            };
+            summary_accumulation_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            summary_where: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        if: {
+            properties: {
+                summary_field_id: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+        then: {
+            required: string[];
+        };
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the create_relationship tool
+     * @param params Tool parameters
+     * @returns Created relationship details
+     */
+    protected run(params: CreateRelationshipParams): Promise<CreateRelationshipResult>;
+}

package/dist/tools/relationships/create_relationship.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateRelationshipTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("CreateRelationshipTool");
+/**
+ * Tool for creating a new table-to-table relationship in Quickbase.
+ *
+ * Creates a reference field in the child table linking to the parent table.
+ * Optionally creates lookup fields and/or summary fields.
+ */
+class CreateRelationshipTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "create_relationship";
+        this.description = "Creates a new table-to-table relationship linking a child table to a parent table. " +
+            "This creates a reference field in the child table. Optionally creates lookup fields " +
+            "(to display parent data in child records) and/or a summary field (to aggregate child " +
+            "data in parent records). Relationships can only be created between tables in the same " +
+            "application. This operation is SAFE and does not modify existing data.";
+        /**
+         * Parameter schema for create_relationship with conditional validation
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the child Quickbase table (DBID) where the relationship reference field will be created",
+                },
+                parent_table_id: {
+                    type: "string",
+                    description: "The ID of the parent Quickbase table (DBID) to link to",
+                },
+                foreign_key_label: {
+                    type: "string",
+                    description: "Optional label for the foreign key reference field created in the child table",
+                },
+                lookup_field_ids: {
+                    type: "array",
+                    items: {
+                        type: "number",
+                    },
+                    description: "Optional array of parent field IDs to create as lookup fields in the child table",
+                },
+                summary_field_id: {
+                    type: "number",
+                    description: "Optional child field ID to summarize in the parent table",
+                },
+                summary_label: {
+                    type: "string",
+                    description: "Optional label for the summary field created in the parent table",
+                },
+                summary_accumulation_type: {
+                    type: "string",
+                    enum: ["SUM", "COUNT", "AVG", "MAX", "MIN"],
+                    description: "Accumulation type for the summary field. Required when summary_field_id is provided. " +
+                        "Valid values: SUM, COUNT, AVG, MAX, MIN",
+                },
+                summary_where: {
+                    type: "string",
+                    description: "Optional Quickbase query filter for the summary field (e.g., \"{6.EX.'Active'}\")",
+                },
+            },
+            required: ["table_id", "parent_table_id"],
+            // Conditional validation: summary_accumulation_type is required when summary_field_id is provided
+            if: {
+                properties: { summary_field_id: { type: "number" } },
+                required: ["summary_field_id"],
+            },
+            then: {
+                required: ["summary_accumulation_type"],
+            },
+        };
+    }
+    /**
+     * Run the create_relationship tool
+     * @param params Tool parameters
+     * @returns Created relationship details
+     */
+    async run(params) {
+        const { table_id, parent_table_id, foreign_key_label, lookup_field_ids, summary_field_id, summary_label, summary_accumulation_type, summary_where, } = params;
+        logger.info("Creating relationship between tables", {
+            childTableId: table_id,
+            parentTableId: parent_table_id,
+            hasLookupFields: !!lookup_field_ids?.length,
+            hasSummaryField: !!summary_field_id,
+        });
+        // Validate conditional requirement: summary_accumulation_type required when summary_field_id is provided
+        if (summary_field_id !== undefined && !summary_accumulation_type) {
+            const errorMessage = "summary_accumulation_type is required when summary_field_id is provided. " +
+                "Valid values: SUM, COUNT, AVG, MAX, MIN";
+            logger.error("Validation failed", { error: errorMessage });
+            throw new Error(errorMessage);
+        }
+        // Build the request body according to Quickbase API format
+        const body = {
+            parentTableId: parent_table_id,
+        };
+        // Add optional foreign key label
+        if (foreign_key_label) {
+            body.foreignKeyField = {
+                label: foreign_key_label,
+            };
+        }
+        // Add lookup fields if provided
+        if (lookup_field_ids && lookup_field_ids.length > 0) {
+            body.lookupFieldIds = lookup_field_ids;
+        }
+        // Add summary field configuration if provided
+        if (summary_field_id !== undefined && summary_accumulation_type) {
+            const summaryField = {
+                summaryFid: summary_field_id,
+                accumulationType: summary_accumulation_type,
+            };
+            if (summary_label) {
+                summaryField.label = summary_label;
+            }
+            if (summary_where) {
+                summaryField.where = summary_where;
+            }
+            body.summaryFields = [summaryField];
+        }
+        // Create the relationship
+        const response = await this.client.request({
+            method: "POST",
+            path: `/tables/${table_id}/relationship`,
+            body,
+        });
+        if (!response.success || !response.data) {
+            logger.error("Failed to create relationship", {
+                error: response.error,
+                childTableId: table_id,
+                parentTableId: parent_table_id,
+            });
+            throw new Error(response.error?.message || "Failed to create relationship");
+        }
+        // Parse and transform the API response
+        const data = response.data;
+        const foreignKeyField = data.foreignKeyField;
+        const lookupFields = data.lookupFields;
+        const summaryFields = data.summaryFields;
+        const result = {
+            id: data.id,
+            parentTableId: data.parentTableId,
+            childTableId: data.childTableId,
+            foreignKeyField: foreignKeyField
+                ? {
+                    id: foreignKeyField.id,
+                    label: foreignKeyField.label,
+                    type: foreignKeyField.type,
+                }
+                : { id: 0, label: "", type: "" },
+            lookupFields: (lookupFields || []).map((field) => ({
+                id: field.id,
+                label: field.label,
+                type: field.type,
+            })),
+            summaryFields: (summaryFields || []).map((field) => ({
+                id: field.id,
+                label: field.label,
+                type: field.type,
+            })),
+        };
+        logger.info("Successfully created relationship", {
+            relationshipId: result.id,
+            childTableId: result.childTableId,
+            parentTableId: result.parentTableId,
+            lookupFieldsCreated: result.lookupFields.length,
+            summaryFieldsCreated: result.summaryFields.length,
+        });
+        return result;
+    }
+}
+exports.CreateRelationshipTool = CreateRelationshipTool;
+//# sourceMappingURL=create_relationship.js.map

package/dist/tools/relationships/create_relationship.js.map

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

package/dist/tools/relationships/delete_relationship.d.ts

@@ -0,0 +1,66 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Parameters for delete_relationship tool
+ */
+export interface DeleteRelationshipParams {
+    /**
+     * The ID of the child table (DBID) containing the relationship
+     */
+    table_id: string;
+    /**
+     * The ID of the relationship to delete
+     */
+    relationship_id: number;
+}
+/**
+ * Result from deleting a relationship
+ */
+export interface DeleteRelationshipResult {
+    /**
+     * The ID of the deleted relationship
+     */
+    relationshipId: number;
+    /**
+     * Whether the deletion was successful
+     */
+    deleted: boolean;
+}
+/**
+ * Tool for deleting a table-to-table relationship in Quickbase.
+ *
+ * WARNING: This is a DESTRUCTIVE operation that permanently deletes
+ * the relationship and all associated lookup and summary fields.
+ */
+export declare class DeleteRelationshipTool extends BaseTool<DeleteRelationshipParams, DeleteRelationshipResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for delete_relationship
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            relationship_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the delete_relationship tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    protected run(params: DeleteRelationshipParams): Promise<DeleteRelationshipResult>;
+}

package/dist/tools/relationships/delete_relationship.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteRelationshipTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("DeleteRelationshipTool");
+/**
+ * Tool for deleting a table-to-table relationship in Quickbase.
+ *
+ * WARNING: This is a DESTRUCTIVE operation that permanently deletes
+ * the relationship and all associated lookup and summary fields.
+ */
+class DeleteRelationshipTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "delete_relationship";
+        this.description = "WARNING: DESTRUCTIVE OPERATION - Permanently deletes an entire table-to-table " +
+            "relationship INCLUDING ALL LOOKUP AND SUMMARY FIELDS associated with it. All data " +
+            "in those fields will be permanently lost and CANNOT be recovered. The reference " +
+            "field in the child table will NOT be deleted (it will remain and may need to be " +
+            "manually deleted using field deletion tools if no longer needed). Before using " +
+            "this tool:\n" +
+            "1. Use get_relationships to see what fields will be deleted\n" +
+            "2. Confirm with the user that they want to proceed\n" +
+            "3. Consider if you only need to delete specific fields instead\n\n" +
+            "Only use this tool when you are certain the entire relationship should be removed.";
+        /**
+         * Parameter schema for delete_relationship
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the child Quickbase table (DBID) containing the relationship",
+                },
+                relationship_id: {
+                    type: "number",
+                    description: "The ID of the relationship to delete",
+                },
+            },
+            required: ["table_id", "relationship_id"],
+        };
+    }
+    /**
+     * Run the delete_relationship tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    async run(params) {
+        const { table_id, relationship_id } = params;
+        // Use logger.warn for destructive operations
+        logger.warn("Deleting relationship", {
+            tableId: table_id,
+            relationshipId: relationship_id,
+        });
+        // Delete the relationship
+        const response = await this.client.request({
+            method: "DELETE",
+            path: `/tables/${table_id}/relationship/${relationship_id}`,
+        });
+        if (!response.success) {
+            logger.error("Failed to delete relationship", {
+                error: response.error,
+                tableId: table_id,
+                relationshipId: relationship_id,
+            });
+            throw new Error(response.error?.message || "Failed to delete relationship");
+        }
+        logger.warn("Successfully deleted relationship", {
+            tableId: table_id,
+            relationshipId: relationship_id,
+        });
+        return {
+            relationshipId: relationship_id,
+            deleted: true,
+        };
+    }
+}
+exports.DeleteRelationshipTool = DeleteRelationshipTool;
+//# sourceMappingURL=delete_relationship.js.map

package/dist/tools/relationships/delete_relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_relationship.js","sourceRoot":"","sources":["../../../src/tools/relationships/delete_relationship.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,wBAAwB,CAAC,CAAC;AAgCtD;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,eAG3C;IAiCC;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QArCT,SAAI,GAAG,qBAAqB,CAAC;QAC7B,gBAAW,GAChB,gFAAgF;YAChF,oFAAoF;YACpF,kFAAkF;YAClF,kFAAkF;YAClF,iFAAiF;YACjF,cAAc;YACd,+DAA+D;YAC/D,sDAAsD;YACtD,oEAAoE;YACpE,oFAAoF,CAAC;QAEvF;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wEAAwE;iBAC3E;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;SAC1C,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CACjB,MAAgC;QAEhC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAE7C,6CAA6C;QAC7C,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,OAAO,EAAE,QAAQ;YACjB,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW,QAAQ,iBAAiB,eAAe,EAAE;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBAC5C,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,cAAc,EAAE,eAAe;aAChC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,+BAA+B,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC/C,OAAO,EAAE,QAAQ;YACjB,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QAEH,OAAO;YACL,cAAc,EAAE,eAAe;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF;AAvFD,wDAuFC"}