@iflow-mcp/attio-mcp 1.3.6

package/dist/objects/people/search.js

@@ -0,0 +1,280 @@
+/**
+ * Search functionality for People
+ */
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { searchObject, advancedSearchObject, } from '../../api/operations/index.js';
+import { ResourceType, } from '../../types/attio.js';
+import { createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, } from '../../utils/filters/index.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { validateDateRange, validateActivityFilter, validateNumericParam, } from '../../utils/filters/index.js';
+import { createPaginatedResponse, } from '../../utils/pagination.js';
+import { isValidEmail } from '../../utils/validation/email-validation.js';
+/**
+ * Searches for people by name, email, or phone number
+ *
+ * @param query - Search query string
+ * @returns Array of person results
+ */
+export async function searchPeople(query) {
+    try {
+        if (!query || query.trim().length === 0) {
+            throw new FilterValidationError('Search query cannot be empty');
+        }
+        if (query.length > 1000) {
+            throw new FilterValidationError('Search query too long');
+        }
+        // Use the API directly to avoid the phone field issue
+        const api = getLazyAttioClient();
+        const path = `/objects/people/records/query`;
+        // Search only by name and email, not phone
+        const filter = {
+            $or: [
+                { name: { $contains: query } },
+                { email_addresses: { $contains: query } },
+            ],
+        };
+        const response = await api.post(path, {
+            filter,
+            limit: 50,
+        });
+        return response.data.data || [];
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to search people: ${errorMessage}`);
+    }
+}
+/**
+ * Searches for people using query (alias for searchPeople)
+ *
+ * @param query - Search query string
+ * @returns Array of person results
+ */
+export async function searchPeopleByQuery(query) {
+    try {
+        if (!query || query.trim().length === 0) {
+            throw new FilterValidationError('Search query cannot be empty');
+        }
+        if (query.length > 1000) {
+            throw new FilterValidationError('Search query too long');
+        }
+        const response = await searchObject(ResourceType.PEOPLE, query);
+        return response;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to search people by query: ${errorMessage}`);
+    }
+}
+/**
+ * Searches for people by email address
+ *
+ * @param email - Email address to search for
+ * @returns Array of person results
+ */
+export async function searchPeopleByEmail(email) {
+    try {
+        if (!email || email.trim().length === 0) {
+            throw new FilterValidationError('Email cannot be empty');
+        }
+        if (!isValidEmail(email)) {
+            throw new FilterValidationError(`Invalid email format: ${email}`);
+        }
+        const response = await searchObject(ResourceType.PEOPLE, email);
+        return response;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Email search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to search people by email: ${errorMessage}`);
+    }
+}
+/**
+ * Searches for people by phone number
+ *
+ * @param phone - Phone number to search for
+ * @returns Array of person results
+ */
+export async function searchPeopleByPhone(phone) {
+    try {
+        const response = await searchObject(ResourceType.PEOPLE, phone);
+        return response;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to search people by phone: ${errorMessage}`);
+    }
+}
+/**
+ * getPersonByEmail (alias for searchPeopleByEmail)
+ *
+ * @param email - Email address to search for
+ * @returns Array of person results
+ */
+export async function getPersonByEmail(email) {
+    return searchPeopleByEmail(email);
+}
+/**
+ * Searches people using advanced filter criteria
+ *
+ * @param filters - Filter criteria including attribute filters, date ranges, etc.
+ * @param options - Optional search configuration including pagination
+ * @returns Array of person results
+ */
+export async function advancedSearchPeople(filters, options) {
+    try {
+        // Validate pagination parameters
+        if (options?.limit) {
+            try {
+                const validatedLimit = validateNumericParam(options.limit, 'limit');
+                if (validatedLimit < 0 || validatedLimit > 500) {
+                    throw new FilterValidationError('limit must be between 0 and 500');
+                }
+            }
+            catch (error) {
+                if (error instanceof FilterValidationError) {
+                    throw error;
+                }
+                throw new FilterValidationError(`Invalid limit: ${error}`);
+            }
+        }
+        if (options?.offset) {
+            try {
+                const validatedOffset = validateNumericParam(options.offset, 'offset');
+                if (validatedOffset < 0) {
+                    throw new FilterValidationError('offset cannot be negative');
+                }
+            }
+            catch (error) {
+                if (error instanceof FilterValidationError) {
+                    throw error;
+                }
+                throw new FilterValidationError(`Invalid offset: ${error}`);
+            }
+        }
+        const searchParams = {
+            ...filters,
+            sorts: options?.sorts,
+        };
+        const response = await advancedSearchObject(ResourceType.PEOPLE, searchParams, options?.limit || 100, options?.offset || 0);
+        const offset = options?.offset || 0;
+        const limit = options?.limit || 100;
+        const page = Math.floor(offset / limit) + 1;
+        return createPaginatedResponse(response, response.length, page, limit);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Advanced search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to perform advanced people search: ${errorMessage}`);
+    }
+}
+/**
+ * Searches for people created within a date range
+ *
+ * @param dateRange - Date range for creation date
+ * @returns Array of people created within the specified range
+ */
+export async function searchPeopleByCreationDate(dateRange) {
+    try {
+        validateDateRange(dateRange);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Invalid date range: ${error}`);
+    }
+    const filters = createCreatedDateFilter(dateRange);
+    const response = await advancedSearchPeople(filters);
+    return response.results;
+}
+/**
+ * Searches for people modified within a date range
+ *
+ * @param dateRange - Date range for modification date
+ * @returns Array of people modified within the specified range
+ */
+export async function searchPeopleByModificationDate(dateRange) {
+    try {
+        validateDateRange(dateRange);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Invalid date range: ${error}`);
+    }
+    const filters = createModifiedDateFilter(dateRange);
+    const response = await advancedSearchPeople(filters);
+    return response.results;
+}
+/**
+ * Searches for people by last interaction date
+ *
+ * @param dateRange - Date range for last interaction
+ * @param interactionType - Optional type of interaction to filter by
+ * @returns Array of people with interactions in the specified range
+ */
+export async function searchPeopleByLastInteraction(dateRange, interactionType) {
+    try {
+        try {
+            validateDateRange(dateRange);
+        }
+        catch (error) {
+            if (error instanceof FilterValidationError) {
+                throw error;
+            }
+            throw new FilterValidationError(`Invalid date range: ${error}`);
+        }
+        const filters = createLastInteractionFilter(dateRange, interactionType);
+        const response = await advancedSearchPeople(filters);
+        return response.results;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Last interaction search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to search people by last interaction: ${errorMessage}`);
+    }
+}
+/**
+ * Searches for people by activity (meetings, emails, calls)
+ *
+ * @param activityFilter - Activity type and optional date range
+ * @returns Array of people with the specified activity
+ */
+export async function searchPeopleByActivity(activityFilter) {
+    try {
+        try {
+            validateActivityFilter(activityFilter);
+        }
+        catch (error) {
+            if (error instanceof FilterValidationError) {
+                throw error;
+            }
+            throw new FilterValidationError(`Invalid activity filter: ${error}`);
+        }
+        const filters = createActivityFilter(activityFilter);
+        const response = await advancedSearchPeople(filters);
+        return response.results;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Activity search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to search people by activity: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/objects/people/search.js.map

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

package/dist/objects/people/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Interface for attributes when creating or updating a person
+ * Based on standard Attio People API fields
+ */
+export interface PersonAttributes {
+    /** Person's full name */
+    name?: string;
+    /** Person's description */
+    description?: string;
+    /** Email addresses (array of strings) */
+    email_addresses?: string[];
+    /** Job title */
+    job_title?: string;
+    /** Associated company ID or company name to look up */
+    company?: string | {
+        record_id: string;
+    };
+    /** LinkedIn profile URL */
+    linkedin?: string;
+    /** Twitter profile URL */
+    twitter?: string;
+    /** Facebook profile URL */
+    facebook?: string;
+    /** Instagram profile URL */
+    instagram?: string;
+    /** Phone numbers (array of strings) */
+    phone_numbers?: string[];
+    /** Primary location information */
+    primary_location?: string;
+    /** Avatar URL */
+    avatar_url?: string;
+    /** AngelList profile URL */
+    angellist?: string;
+    /** Associated deals */
+    associated_deals?: string[] | {
+        record_id: string;
+    }[];
+    /** Associated users */
+    associated_users?: string[] | {
+        record_id: string;
+    }[];
+    /** Custom attributes - any fields not in the standard schema */
+    [key: string]: string | string[] | number | boolean | {
+        record_id: string;
+    } | {
+        record_id: string;
+    }[] | undefined;
+}
+export { PersonOperationError, InvalidPersonDataError } from './errors.js';
+export declare class PersonValidator {
+    static validateCreate(attributes: PersonAttributes): Promise<PersonAttributes>;
+    static validateUpdate(personId: string, attributes: PersonAttributes): Promise<PersonAttributes>;
+    static validateAttributeUpdate(personId: string, attributeName: string, attributeValue: string | string[] | {
+        record_id: string;
+    } | undefined): Promise<void>;
+    static validateDelete(personId: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/objects/people/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/objects/people/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAEtD,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAEtD,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,GACN,MAAM,EAAE,GACR,MAAM,GACN,OAAO,GACP;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GACrB;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,GACvB,SAAS,CAAC;CACf;AAGD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG3E,qBAAa,eAAe;WACb,cAAc,CACzB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;WAiFf,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;WAef,uBAAuB,CAClC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GACpE,OAAO,CAAC,IAAI,CAAC;IA8EhB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAK9C"}

package/dist/objects/people/types.js

@@ -0,0 +1,149 @@
+/**
+ * Shared types for people module
+ */
+import { isValidEmail } from '../../utils/validation/email-validation.js';
+import { InvalidPersonDataError } from './errors.js';
+// Re-export error classes for backward compatibility
+export { PersonOperationError, InvalidPersonDataError } from './errors.js';
+// Validator for person data
+export class PersonValidator {
+    static async validateCreate(attributes) {
+        // Basic validation - ensure we have at least an email or name
+        if (!attributes.email_addresses && !attributes.name) {
+            throw new InvalidPersonDataError('Must provide at least an email address or name');
+        }
+        // Ensure email_addresses is an array if provided
+        if (attributes.email_addresses &&
+            !Array.isArray(attributes.email_addresses)) {
+            attributes.email_addresses = [attributes.email_addresses];
+        }
+        // Validate email format
+        if (attributes.email_addresses) {
+            for (const emailItem of attributes.email_addresses) {
+                let emailAddress;
+                // Handle different email formats (same logic as ValidationService)
+                if (typeof emailItem === 'string') {
+                    emailAddress = emailItem;
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'email_address' in emailItem) {
+                    const emailValue = emailItem
+                        .email_address;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: email_address must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'email' in emailItem) {
+                    const emailValue = emailItem.email;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: email must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'value' in emailItem) {
+                    const emailValue = emailItem.value;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: value must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else {
+                    throw new InvalidPersonDataError(`Invalid email format: "${JSON.stringify(emailItem)}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+                if (!isValidEmail(emailAddress)) {
+                    throw new InvalidPersonDataError(`Invalid email format: "${emailAddress}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+            }
+        }
+        return attributes;
+    }
+    static async validateUpdate(personId, attributes) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+        // Ensure at least one attribute is being updated
+        if (!attributes || Object.keys(attributes).length === 0) {
+            throw new InvalidPersonDataError('Must provide at least one attribute to update');
+        }
+        return attributes;
+    }
+    static async validateAttributeUpdate(personId, attributeName, attributeValue) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+        if (!attributeName || typeof attributeName !== 'string') {
+            throw new InvalidPersonDataError('Attribute name must be a non-empty string');
+        }
+        // Special validation for email_addresses
+        if (attributeName === 'email_addresses' && attributeValue) {
+            const emails = Array.isArray(attributeValue)
+                ? attributeValue
+                : [attributeValue];
+            for (const emailItem of emails) {
+                let emailAddress;
+                // Handle different email formats (same logic as ValidationService)
+                if (typeof emailItem === 'string') {
+                    emailAddress = emailItem;
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'email_address' in emailItem) {
+                    const emailValue = emailItem
+                        .email_address;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: email_address must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'email' in emailItem) {
+                    const emailValue = emailItem.email;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: email must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else if (typeof emailItem === 'object' &&
+                    emailItem &&
+                    'value' in emailItem) {
+                    const emailValue = emailItem.value;
+                    if (typeof emailValue === 'string') {
+                        emailAddress = emailValue;
+                    }
+                    else {
+                        throw new InvalidPersonDataError(`Invalid email format: value must be a string, got ${typeof emailValue}. Please provide a valid email address (e.g., user@example.com)`);
+                    }
+                }
+                else {
+                    throw new InvalidPersonDataError(`Invalid email format: "${JSON.stringify(emailItem)}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+                if (!isValidEmail(emailAddress)) {
+                    throw new InvalidPersonDataError(`Invalid email format: "${emailAddress}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+            }
+        }
+    }
+    static validateDelete(personId) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/objects/people/types.js.map

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

package/dist/objects/people-write.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Write operations for People with dynamic field detection
+ */
+import { Person, PersonCreateAttributes } from '../types/attio.js';
+import { PersonAttributes } from './people/types.js';
+export { PersonOperationError, InvalidPersonDataError, } from './people/errors.js';
+/**
+ * Simple validator for person data
+ * Can be enhanced with more specific validation rules
+ */
+export declare class PersonValidator {
+    static validateCreate(attributes: PersonCreateAttributes): Promise<PersonCreateAttributes>;
+    static validateUpdate(personId: string, attributes: PersonAttributes): Promise<PersonAttributes>;
+    static validateAttributeUpdate(personId: string, attributeName: string, attributeValue: string | string[] | {
+        record_id: string;
+    } | undefined): Promise<void>;
+    static validateDelete(personId: string): void;
+}
+/**
+ * Creates a new person
+ *
+ * @param attributes - Person attributes as key-value pairs
+ * @returns Created person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if creation fails
+ */
+export declare function createPerson(attributes: PersonCreateAttributes): Promise<Person>;
+/**
+ * Updates an existing person
+ *
+ * @param personId - ID of the person to update
+ * @param attributes - Person attributes to update
+ * @returns Updated person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if update fails
+ */
+export declare function updatePerson(personId: string, attributes: PersonAttributes): Promise<Person>;
+/**
+ * Updates a specific attribute of a person
+ *
+ * @param personId - ID of the person to update
+ * @param attributeName - Name of the attribute to update
+ * @param attributeValue - New value for the attribute
+ * @returns Updated person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if update fails
+ */
+export declare function updatePersonAttribute(personId: string, attributeName: string, attributeValue: string | string[] | {
+    record_id: string;
+} | undefined): Promise<Person>;
+/**
+ * Deletes a person
+ *
+ * @param personId - ID of the person to delete
+ * @returns True if deletion was successful
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if deletion fails
+ */
+export declare function deletePerson(personId: string): Promise<boolean>;
+//# sourceMappingURL=people-write.d.ts.map

package/dist/objects/people-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people-write.d.ts","sourceRoot":"","sources":["../../src/objects/people-write.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAYnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAsCrD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,qBAAa,eAAe;WACb,cAAc,CACzB,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,sBAAsB,CAAC;WA2FrB,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;WAef,uBAAuB,CAClC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GACpE,OAAO,CAAC,IAAI,CAAC;IAgDhB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAK9C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACpE,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBrE"}