@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/rate-limiter.js

@@ -0,0 +1,160 @@
+/**
+ * Rate limiter utility for Attio MCP server
+ * Provides simple rate limiting functionality for API endpoints
+ */
+/**
+ * Rate limiter implementation
+ */
+export class RateLimiter {
+    requests;
+    config;
+    /**
+     * Create a new rate limiter
+     *
+     * @param config - Rate limiter configuration
+     */
+    constructor(config) {
+        this.requests = new Map();
+        this.config = {
+            maxRequests: config.maxRequests,
+            windowMs: config.windowMs,
+            trackByIp: config.trackByIp !== false, // Default to true
+            keyFn: config.keyFn,
+        };
+    }
+    /**
+     * Check if a request is allowed
+     *
+     * @param req - Request object (with IP address or other identifying info)
+     * @returns Object with allowed status and rate limit info
+     */
+    check(req) {
+        const now = Date.now();
+        // Get the key to track this request by
+        const key = this.getKey(req);
+        // Get or create record for this key
+        let record = this.requests.get(key);
+        if (!record || now > record.resetTime) {
+            // If no record exists or the window has passed, create a new one
+            record = {
+                count: 0,
+                resetTime: now + this.config.windowMs,
+            };
+            this.requests.set(key, record);
+        }
+        // Check if request is allowed
+        const allowed = record.count < this.config.maxRequests;
+        // Increment counter if allowed
+        if (allowed) {
+            record.count++;
+        }
+        // Return result
+        return {
+            allowed,
+            remaining: Math.max(0, this.config.maxRequests - record.count),
+            resetTime: record.resetTime,
+            msUntilReset: Math.max(0, record.resetTime - now),
+        };
+    }
+    /**
+     * Cleanup old entries to prevent memory leaks
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, record] of Array.from(this.requests.entries())) {
+            if (now > record.resetTime) {
+                this.requests.delete(key);
+            }
+        }
+    }
+    /**
+     * Get the key to track a request by
+     *
+     * @param req - Request object
+     * @returns Key for rate limiting
+     */
+    getKey(req) {
+        // Use custom key function if provided
+        if (this.config.keyFn) {
+            return this.config.keyFn(req);
+        }
+        // Track by IP if configured
+        if (this.config.trackByIp) {
+            const reqWithIp = req;
+            const ip = reqWithIp.ip ||
+                reqWithIp.connection?.remoteAddress ||
+                reqWithIp.headers?.['x-forwarded-for'] ||
+                'unknown';
+            return `ip:${ip}`;
+        }
+        // Default to a static key (not recommended for production)
+        return 'global';
+    }
+}
+// Global rate limiter instances
+const rateLimiters = new Map();
+/**
+ * Get or create a rate limiter for a specific endpoint
+ *
+ * @param endpoint - Endpoint to rate limit
+ * @param config - Rate limiter configuration
+ * @returns Rate limiter instance
+ */
+export function getRateLimiter(endpoint, config) {
+    // Check if limiter already exists
+    let limiter = rateLimiters.get(endpoint);
+    if (!limiter) {
+        // Create new limiter
+        limiter = new RateLimiter(config);
+        rateLimiters.set(endpoint, limiter);
+    }
+    return limiter;
+}
+/**
+ * Middleware for rate limiting Express requests
+ *
+ * @param config - Rate limiter configuration
+ * @returns Express middleware function
+ */
+export function rateLimiterMiddleware(config) {
+    const limiter = new RateLimiter(config);
+    // Schedule cleanup every windowMs to prevent memory leaks
+    setInterval(() => limiter.cleanup(), config.windowMs);
+    return (req, res, next) => {
+        const result = limiter.check(req);
+        // Add rate limit headers
+        res.setHeader('X-RateLimit-Limit', config.maxRequests);
+        res.setHeader('X-RateLimit-Remaining', result.remaining);
+        res.setHeader('X-RateLimit-Reset', result.resetTime);
+        if (!result.allowed) {
+            // Return 429 Too Many Requests
+            res.status(429).json({
+                error: 'Too many requests',
+                message: `Rate limit exceeded. Try again in ${Math.ceil(result.msUntilReset / 1000)} seconds.`,
+                retryAfter: Math.ceil(result.msUntilReset / 1000),
+            });
+            return;
+        }
+        next();
+    };
+}
+/**
+ * Rate limiting for filter operations
+ *
+ * @param req - Request object
+ * @param endpoint - Endpoint being accessed
+ * @returns Object with allowed status and rate limit info
+ */
+export function checkFilterRateLimit(req, endpoint) {
+    // Configuration for filter endpoints
+    const config = {
+        maxRequests: 60, // 60 requests
+        windowMs: 60 * 1000, // per minute
+        trackByIp: true, // track by IP address
+    };
+    // Get limiter for this endpoint
+    const limiter = getRateLimiter(`filter:${endpoint}`, config);
+    // Check rate limit
+    return limiter.check(req);
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

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

package/dist/utils/record-utils.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Utility functions for working with Attio records and responses
+ * Provides functions for processing list entries, extracting record information,
+ * and interacting with the Attio API.
+ */
+import { AttioListEntry } from '../types/attio.js';
+import { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter } from './filters/index.js';
+export { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, };
+export declare const API_PARAMS: {
+    EXPAND: string;
+    RECORD: string;
+    LIMIT: string;
+    OFFSET: string;
+    LIST_ID: string;
+};
+export declare const ATTRIBUTE_SLUGS: {
+    CREATED_AT: string;
+    UPDATED_AT: string;
+    LAST_INTERACTION: string;
+    INTERACTION_TYPE: string;
+    EMAIL: string;
+    PHONE: string;
+    NAME: string;
+    DOMAINS: string;
+    CATEGORIES: string;
+    REVENUE: string;
+    EMPLOYEE_COUNT: string;
+    LIST_ID: string;
+    NOTE_CONTENT: string;
+    RELATIONSHIP: string;
+};
+/**
+ * Extracts and ensures record_id is properly populated in list entries
+ *
+ * @param entries - Raw list entries from API response
+ * @returns Processed list entries with record_id correctly populated
+ */
+export declare function processListEntries(entries: AttioListEntry[]): AttioListEntry[];
+/**
+ * Safely extracts record name and type from a list entry if available
+ *
+ * @param entry - List entry that may contain record data
+ * @returns An object with record name and type or empty values if not available
+ */
+export declare function getRecordNameFromEntry(entry: AttioListEntry): {
+    name: string;
+    type: string;
+};
+/**
+ * Creates a path-based filter for filtering list entries by parent record properties
+ *
+ * This function constructs a filter that follows paths through related objects,
+ * which is necessary for filtering list entries based on properties of their parent records.
+ *
+ * @param listSlug - The slug of the list (either the API slug or list ID)
+ * @param parentObjectType - The type of the parent record (e.g., 'companies', 'people')
+ * @param parentAttributeSlug - The attribute of the parent record to filter by
+ * @param condition - The filter condition to apply
+ * @param value - The value to filter by
+ * @returns A filter object compatible with the Attio API for path-based filtering
+ *
+ * @example
+ * // Filter for companies in a list named "prospects" that have "Tech" in their categories
+ * const filter = createPathBasedFilter('prospects', 'companies', 'categories', 'contains', 'Tech');
+ *
+ * @example
+ * // Filter for people in a list with ID "list_12345" who have an email from apple.com
+ * const filter = createPathBasedFilter('list_12345', 'people', 'email_addresses', 'contains', '@apple.com');
+ */
+export declare function createPathBasedFilter(listSlug: string, parentObjectType: string, parentAttributeSlug: string, condition: string, value: unknown): {
+    path: string[][];
+    constraints: Record<string, unknown>;
+};
+//# sourceMappingURL=record-utils.d.ts.map

package/dist/utils/record-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-utils.d.ts","sourceRoot":"","sources":["../../src/utils/record-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,GACpB,CAAC;AAGF,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAAoB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EAAE,GACxB,cAAc,EAAE,CA6JlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CA8CA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,EAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA+E5D"}

package/dist/utils/record-utils.js

@@ -0,0 +1,312 @@
+import { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, FILTER_ATTRIBUTES, } from './filters/index.js';
+// Re-export filter utilities for backwards compatibility
+export { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, };
+// API parameter constants for better maintainability
+export const API_PARAMS = {
+    EXPAND: 'expand',
+    RECORD: 'record',
+    LIMIT: 'limit',
+    OFFSET: 'offset',
+    LIST_ID: 'list_id',
+};
+// Re-export attribute slugs for backwards compatibility
+export const ATTRIBUTE_SLUGS = FILTER_ATTRIBUTES;
+/**
+ * Extracts and ensures record_id is properly populated in list entries
+ *
+ * @param entries - Raw list entries from API response
+ * @returns Processed list entries with record_id correctly populated
+ */
+export function processListEntries(entries) {
+    return entries.map((entry) => {
+        // Debug logging in development mode
+        if (process.env.NODE_ENV === 'development') {
+            console.error(`[processListEntries] Processing entry:`, {
+                entryId: entry.id?.entry_id || 'unknown',
+                hasRecordId: !!entry.record_id,
+                hasRecord: !!entry.record,
+                hasParentRecordId: !!entry.parent_record_id,
+                valueKeys: entry.values ? Object.keys(entry.values) : [],
+            });
+        }
+        // If record_id is already defined and non-empty, no processing needed
+        if (entry.record_id &&
+            typeof entry.record_id === 'string' &&
+            entry.record_id.trim() !== '') {
+            return entry;
+        }
+        // Enhanced record_id extraction from multiple possible locations
+        let recordId;
+        // Option 1: Direct parent_record_id property
+        if (entry.parent_record_id) {
+            recordId = entry.parent_record_id;
+        }
+        // Option 2: Nested in record object
+        else if (entry.record?.id?.record_id) {
+            recordId = entry.record.id.record_id;
+        }
+        // Option 3: Nested in values.record_id
+        else if (entry.values &&
+            typeof entry.values === 'object' &&
+            'record_id' in entry.values) {
+            const recordIdValue = entry.values.record_id;
+            if (Array.isArray(recordIdValue) && recordIdValue.length > 0) {
+                // Handle array of values with possible value property
+                if (recordIdValue[0].value) {
+                    recordId = recordIdValue[0].value;
+                }
+                else if (typeof recordIdValue[0] === 'string') {
+                    recordId = recordIdValue[0];
+                }
+            }
+            else if (typeof recordIdValue === 'string') {
+                recordId = recordIdValue;
+            }
+        }
+        // Option 4: Nested in values.record
+        else if (entry.values &&
+            typeof entry.values === 'object' &&
+            'record' in entry.values) {
+            const valuesWithRecord = entry.values;
+            if (valuesWithRecord.record?.id?.record_id) {
+                recordId = valuesWithRecord.record.id.record_id;
+            }
+        }
+        // Option 5: Check for reference_id property
+        else if (entry.reference_id) {
+            recordId = entry.reference_id;
+        }
+        // Option 6: Check for object_id property
+        else if (entry.object_id) {
+            recordId = entry.object_id;
+        }
+        // Option 7: Search all properties for anything ending with _record_id
+        else {
+            const possibleKeys = Object.keys(entry);
+            for (const key of possibleKeys) {
+                if (key.endsWith('_record_id') &&
+                    typeof entry[key] === 'string' &&
+                    entry[key]) {
+                    recordId = entry[key];
+                    break;
+                }
+            }
+        }
+        // Option 8: If record object exists, look for record.reference_id or record.record_id
+        if (!recordId && entry.record) {
+            if (entry.record.reference_id) {
+                recordId = entry.record.reference_id;
+            }
+            else if (entry.record.record_id) {
+                recordId = entry.record.record_id;
+            }
+            else if (entry.record.id) {
+                // Various id object patterns
+                const idObj = entry.record.id;
+                if (typeof idObj === 'string') {
+                    recordId = idObj;
+                }
+                else if (idObj.record_id) {
+                    recordId = idObj.record_id;
+                }
+                else if (idObj.id && typeof idObj.id === 'string') {
+                    recordId = idObj.id;
+                }
+                else if (idObj.reference_id &&
+                    typeof idObj.reference_id === 'string') {
+                    recordId = idObj.reference_id;
+                }
+            }
+        }
+        // If a record_id was found, return updated entry
+        if (recordId) {
+            if (process.env.NODE_ENV === 'development') {
+                console.error(`[processListEntries] Found record_id: ${recordId} for entry ${entry.id?.entry_id || 'unknown'}`);
+            }
+            return {
+                ...entry,
+                record_id: recordId,
+            };
+        }
+        // Additional fallback: Check if record has a uri property
+        if (entry.record?.uri) {
+            const uriParts = entry.record.uri.split('/');
+            if (uriParts.length > 0) {
+                recordId = uriParts[uriParts.length - 1];
+                if (process.env.NODE_ENV === 'development') {
+                    console.error(`[processListEntries] Extracted record_id ${recordId} from URI: ${entry.record.uri}`);
+                }
+                return {
+                    ...entry,
+                    record_id: recordId,
+                };
+            }
+        }
+        // Unable to find record_id, log warning and return entry unchanged
+        if (process.env.NODE_ENV === 'development') {
+            console.warn(`[processListEntries] Could not extract record_id for entry ${entry.id?.entry_id || 'unknown'}`);
+        }
+        // Return entry unchanged if no record_id found
+        return entry;
+    });
+}
+/**
+ * Safely extracts record name and type from a list entry if available
+ *
+ * @param entry - List entry that may contain record data
+ * @returns An object with record name and type or empty values if not available
+ */
+export function getRecordNameFromEntry(entry) {
+    const defaultResult = { name: '', type: '' };
+    // If no record data is available, return default
+    if (!entry.record || !entry.record.values) {
+        return defaultResult;
+    }
+    // Try to determine the record type based on available fields
+    // Companies typically have categories or domains fields, people typically have email or phone
+    const isPerson = 'email' in entry.record.values || 'phone' in entry.record.values;
+    const isCompany = 'categories' in entry.record.values || 'domains' in entry.record.values;
+    // Set the record type based on detected fields
+    let recordType = '';
+    if (isPerson && !isCompany) {
+        recordType = 'Person';
+    }
+    else if (isCompany && !isPerson) {
+        recordType = 'Company';
+    }
+    else if (entry.record.object_slug) {
+        // If we have an object_slug, use it to determine type
+        recordType =
+            entry.record.object_slug === 'people'
+                ? 'Person'
+                : entry.record.object_slug === 'companies'
+                    ? 'Company'
+                    : '';
+    }
+    // Extract name from the record values
+    const nameValues = entry.record.values.name;
+    let recordName = '';
+    if (Array.isArray(nameValues) &&
+        nameValues.length > 0 &&
+        'value' in nameValues[0]) {
+        recordName = nameValues[0].value || '';
+    }
+    return {
+        name: recordName,
+        type: recordType,
+    };
+}
+/**
+ * Creates a path-based filter for filtering list entries by parent record properties
+ *
+ * This function constructs a filter that follows paths through related objects,
+ * which is necessary for filtering list entries based on properties of their parent records.
+ *
+ * @param listSlug - The slug of the list (either the API slug or list ID)
+ * @param parentObjectType - The type of the parent record (e.g., 'companies', 'people')
+ * @param parentAttributeSlug - The attribute of the parent record to filter by
+ * @param condition - The filter condition to apply
+ * @param value - The value to filter by
+ * @returns A filter object compatible with the Attio API for path-based filtering
+ *
+ * @example
+ * // Filter for companies in a list named "prospects" that have "Tech" in their categories
+ * const filter = createPathBasedFilter('prospects', 'companies', 'categories', 'contains', 'Tech');
+ *
+ * @example
+ * // Filter for people in a list with ID "list_12345" who have an email from apple.com
+ * const filter = createPathBasedFilter('list_12345', 'people', 'email_addresses', 'contains', '@apple.com');
+ */
+export function createPathBasedFilter(listSlug, parentObjectType, parentAttributeSlug, condition, value) {
+    // Create path array for drilling down through objects
+    // First path element is [listSlug, "parent_record"] to navigate from list entry to its parent record
+    // Second path element is [parentObjectType, parentAttributeSlug] to navigate to specific attribute
+    const path = [
+        [listSlug, 'parent_record'],
+        [parentObjectType, parentAttributeSlug],
+    ];
+    // Create constraints object based on condition and value
+    let constraints = {};
+    // Handle different condition types appropriately
+    if (condition === 'equals' || condition === 'eq') {
+        // For exact equality on simple attributes
+        constraints = { value };
+    }
+    else if (condition === 'contains') {
+        // For partial text matching
+        constraints = { contains: value };
+    }
+    else if (condition === 'starts_with') {
+        constraints = { starts_with: value };
+    }
+    else if (condition === 'ends_with') {
+        constraints = { ends_with: value };
+    }
+    else if (condition === 'greater_than' || condition === 'gt') {
+        constraints = { $gt: value }; // Use proper Attio API operator
+    }
+    else if (condition === 'less_than' || condition === 'lt') {
+        constraints = { $lt: value }; // Use proper Attio API operator
+    }
+    else if (condition === 'greater_than_or_equals' || condition === 'gte') {
+        constraints = { $gte: value }; // Use proper Attio API operator
+    }
+    else if (condition === 'less_than_or_equals' || condition === 'lte') {
+        constraints = { $lte: value }; // Use proper Attio API operator
+    }
+    else if (condition === 'not_equals' || condition === 'ne') {
+        constraints = { ne: value };
+    }
+    else if (condition === 'is_empty' || condition === 'is_not_set') {
+        constraints = { is_empty: true };
+    }
+    else if (condition === 'is_not_empty' || condition === 'is_set') {
+        constraints = { $not_empty: true }; // Use proper Attio API operator
+    }
+    else if (condition === 'in') {
+        constraints = { in: Array.isArray(value) ? value : [value] };
+    }
+    else {
+        // Default to exact match if condition is unknown
+        constraints = { value };
+    }
+    // Special case for filtering by record ID
+    if (parentAttributeSlug === 'id' || parentAttributeSlug === 'record_id') {
+        return {
+            path: [[listSlug, 'parent_record']],
+            constraints: { record_id: value },
+        };
+    }
+    // For filtering by name, we need to use full_name property
+    if (parentAttributeSlug === 'name') {
+        if (condition === 'equals') {
+            constraints = { full_name: value };
+        }
+        else if (condition === 'contains') {
+            constraints = { full_name: { contains: value } };
+        }
+        else if (condition === 'starts_with') {
+            constraints = { full_name: { starts_with: value } };
+        }
+        else if (condition === 'ends_with') {
+            constraints = { full_name: { ends_with: value } };
+        }
+    }
+    // For email addresses, we need to use email_address property
+    if (parentAttributeSlug === 'email_addresses') {
+        if (condition === 'equals') {
+            constraints = { email_address: value };
+        }
+        else if (condition === 'contains') {
+            constraints = { email_address: { contains: value } };
+        }
+        else if (condition === 'starts_with') {
+            constraints = { email_address: { starts_with: value } };
+        }
+        else if (condition === 'ends_with') {
+            constraints = { email_address: { ends_with: value } };
+        }
+    }
+    return { path, constraints };
+}
+//# sourceMappingURL=record-utils.js.map

package/dist/utils/record-utils.js.map

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

package/dist/utils/relationship-helpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Utility functions for relationship management
+ */
+/**
+ * Extracts a single record ID from a team member (string or object)
+ * @param item - Team member that can be string or object
+ * @returns Normalized string ID or empty string if invalid
+ */
+export declare function extractSingleRecordId(item: TeamMember): string;
+/**
+ * Type representing a team member that can be either a string ID or an object with target_record_id
+ */
+export type TeamMember = string | {
+    target_record_id?: string;
+    record_id?: string;
+    [key: string]: unknown;
+};
+/**
+ * Extracts normalized record IDs from team member objects or strings
+ * Handles various formats returned by the Attio API
+ *
+ * @param items - Array of team members (strings or objects)
+ * @returns Array of normalized string IDs, filtered to remove empty values
+ */
+export declare function extractRecordIds(items: Array<TeamMember>): string[];
+/**
+ * Interface representing the state of a bidirectional relationship
+ */
+export interface RelationshipState {
+    isInTeam: boolean;
+    isCompanySet: boolean;
+    currentTeamSize: number;
+    needsRepair: boolean;
+}
+/**
+ * Analyzes the current state of a company-person relationship
+ *
+ * @param teamIds - Array of person IDs in the company's team
+ * @param personCompany - Company ID set on the person (can be string, object, or null)
+ * @param targetPersonId - The person ID we're checking
+ * @param targetCompanyId - The company ID we're checking
+ * @returns Object describing the relationship state
+ */
+export declare function analyzeRelationshipState(teamIds: string[], personCompany: string | {
+    target_record_id?: string;
+    record_id?: string;
+} | null, targetPersonId: string, targetCompanyId: string): RelationshipState;
+/**
+ * Executes bidirectional update operations with retry logic and partial failure handling
+ * @param operations - Array of async operations to execute
+ * @param maxRetries - Maximum number of retry attempts (default: 2)
+ * @returns Results of all operations
+ */
+export declare function executeWithRetry<T>(operations: Array<() => Promise<T>>, maxRetries?: number): Promise<T[]>;
+//# sourceMappingURL=relationship-helpers.d.ts.map

package/dist/utils/relationship-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/relationship-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAU9D;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,CAmBnE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EACT,MAAM,GACN;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,EACR,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,iBAAiB,CAqBnB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EACnC,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CA6Cd"}