attio-mcp 0.1.0

package/dist/utils/validation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Validation utility for validating input data against schemas
+ */
+import { ErrorType } from './error-handler.js';
+/**
+ * Result of a validation operation
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Schema definition for validation
+ */
+export interface ValidationSchema {
+    type: string;
+    required?: string[];
+    properties?: Record<string, any>;
+    items?: ValidationSchema;
+    enum?: any[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+}
+/**
+ * Validates input data against a schema and returns the validation result
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @returns Validation result
+ */
+export declare function validateInput(input: any, schema: ValidationSchema): ValidationResult;
+/**
+ * Validates request parameters against a schema and returns a formatted error response if invalid
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @param errorFormatter - Function to format error response
+ * @returns Error response if invalid, null if valid
+ */
+export declare function validateRequest(input: any, schema: ValidationSchema, errorFormatter: (error: Error, type: ErrorType, details: any) => any): any | null;
+/**
+ * Validates that an ID string is valid and secure to use
+ *
+ * @param id - The ID to validate
+ * @returns True if the ID is valid, false otherwise
+ */
+export declare function isValidId(id: string): boolean;
+/**
+ * Validates that a list ID is valid and safe to use
+ * Contains additional validation specific to Attio list IDs
+ *
+ * @param listId - The list ID to validate
+ * @returns True if the list ID is valid, false otherwise
+ */
+export declare function isValidListId(listId: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0OD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAOlB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,GAAG,GACnE,GAAG,GAAG,IAAI,CAYZ;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAuC7C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBrD"}

package/dist/utils/validation.js

@@ -0,0 +1,264 @@
+/**
+ * Validation utility for validating input data against schemas
+ */
+import { ErrorType } from './error-handler.js';
+/**
+ * Create a validation error message for a schema violation
+ *
+ * @param path - Path to the property with an error
+ * @param message - Error message for the violation
+ * @returns Formatted error message
+ */
+function formatError(path, message) {
+    return path ? `${path}: ${message}` : message;
+}
+/**
+ * Validates that a value is of the expected type
+ *
+ * @param value - Value to validate
+ * @param expectedType - Expected type
+ * @param path - Path to the property
+ * @returns Error message if invalid, empty string if valid
+ */
+function validateType(value, expectedType, path) {
+    // Handle null/undefined
+    if (value === null || value === undefined) {
+        return '';
+    }
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string'
+                ? ''
+                : formatError(path, `Expected string, got ${typeof value}`);
+        case 'number':
+            return typeof value === 'number'
+                ? ''
+                : formatError(path, `Expected number, got ${typeof value}`);
+        case 'boolean':
+            return typeof value === 'boolean'
+                ? ''
+                : formatError(path, `Expected boolean, got ${typeof value}`);
+        case 'array':
+            return Array.isArray(value)
+                ? ''
+                : formatError(path, `Expected array, got ${typeof value}`);
+        case 'object':
+            return typeof value === 'object' && !Array.isArray(value)
+                ? ''
+                : formatError(path, `Expected object, got ${typeof value}`);
+        default:
+            return formatError(path, `Unknown type ${expectedType}`);
+    }
+}
+/**
+ * Validates that a value matches the schema's constraints
+ *
+ * @param value - Value to validate
+ * @param schema - Schema to validate against
+ * @param path - Path to the property
+ * @returns Array of error messages
+ */
+function validateConstraints(value, schema, path) {
+    const errors = [];
+    // Skip validation for null/undefined values
+    if (value === null || value === undefined) {
+        return errors;
+    }
+    // Enum validation
+    if (schema.enum && !schema.enum.includes(value)) {
+        errors.push(formatError(path, `Value must be one of: ${schema.enum.join(', ')}`));
+    }
+    // String constraints
+    if (typeof value === 'string') {
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            errors.push(formatError(path, `String must be at least ${schema.minLength} characters long`));
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            errors.push(formatError(path, `String must be at most ${schema.maxLength} characters long`));
+        }
+        if (schema.pattern) {
+            const regex = new RegExp(schema.pattern);
+            if (!regex.test(value)) {
+                errors.push(formatError(path, `String must match pattern: ${schema.pattern}`));
+            }
+        }
+    }
+    // Number constraints
+    if (typeof value === 'number') {
+        if (schema.minimum !== undefined && value < schema.minimum) {
+            errors.push(formatError(path, `Number must be greater than or equal to ${schema.minimum}`));
+        }
+        if (schema.maximum !== undefined && value > schema.maximum) {
+            errors.push(formatError(path, `Number must be less than or equal to ${schema.maximum}`));
+        }
+    }
+    // Array constraints
+    if (Array.isArray(value) && schema.items) {
+        value.forEach((item, index) => {
+            const itemPath = path ? `${path}[${index}]` : `[${index}]`;
+            // Validate type
+            const itemSchema = schema.items;
+            const typeError = validateType(item, itemSchema.type, itemPath);
+            if (typeError) {
+                errors.push(typeError);
+            }
+            // Validate constraints recursively
+            const constraintErrors = validateConstraints(item, itemSchema, itemPath);
+            errors.push(...constraintErrors);
+            // Validate nested object or array
+            if ((itemSchema.type === 'object' || itemSchema.type === 'array') &&
+                item !== null &&
+                item !== undefined) {
+                const nestedErrors = validateValue(item, itemSchema, itemPath);
+                errors.push(...nestedErrors);
+            }
+        });
+    }
+    return errors;
+}
+/**
+ * Validates a value against a schema
+ *
+ * @param value - Value to validate
+ * @param schema - Schema to validate against
+ * @param path - Path to the property
+ * @returns Array of error messages
+ */
+function validateValue(value, schema, path = '') {
+    const errors = [];
+    // Type validation
+    const typeError = validateType(value, schema.type, path);
+    if (typeError) {
+        errors.push(typeError);
+        return errors; // Don't continue validation if type is wrong
+    }
+    // Validate constraints
+    const constraintErrors = validateConstraints(value, schema, path);
+    errors.push(...constraintErrors);
+    // Object validation
+    if (schema.type === 'object' && schema.properties && value) {
+        // Required properties validation
+        if (schema.required) {
+            for (const requiredProp of schema.required) {
+                if (!(requiredProp in value)) {
+                    errors.push(formatError(path ? `${path}.${requiredProp}` : requiredProp, 'Required property is missing'));
+                }
+            }
+        }
+        // Property validation
+        if (schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                if (propName in value) {
+                    const propPath = path ? `${path}.${propName}` : propName;
+                    const propValue = value[propName];
+                    // Skip undefined/null for non-required fields
+                    if ((propValue === undefined || propValue === null) &&
+                        (!schema.required || !schema.required.includes(propName))) {
+                        continue;
+                    }
+                    const propErrors = validateValue(propValue, propSchema, propPath);
+                    errors.push(...propErrors);
+                }
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Validates input data against a schema and returns the validation result
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @returns Validation result
+ */
+export function validateInput(input, schema) {
+    const errors = validateValue(input, schema);
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validates request parameters against a schema and returns a formatted error response if invalid
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @param errorFormatter - Function to format error response
+ * @returns Error response if invalid, null if valid
+ */
+export function validateRequest(input, schema, errorFormatter) {
+    const result = validateInput(input, schema);
+    if (!result.isValid) {
+        const error = new Error('Validation error: Invalid request parameters');
+        return errorFormatter(error, ErrorType.VALIDATION_ERROR, {
+            errors: result.errors,
+            input,
+        });
+    }
+    return null;
+}
+/**
+ * Validates that an ID string is valid and secure to use
+ *
+ * @param id - The ID to validate
+ * @returns True if the ID is valid, false otherwise
+ */
+export function isValidId(id) {
+    // Basic check for non-empty string
+    if (!id || typeof id !== 'string' || id.trim() === '') {
+        return false;
+    }
+    // Check that the ID has a reasonable length
+    if (id.length < 3 || id.length > 100) {
+        return false;
+    }
+    // Check that the ID only contains valid characters
+    // Allowing alphanumeric, hyphens, and underscores
+    if (!/^[a-zA-Z0-9_-]+$/.test(id)) {
+        return false;
+    }
+    // Check for dangerous patterns that could be used for injection
+    const dangerousPatterns = [
+        /--/, // SQL comment marker
+        /\/\*/, // SQL block comment start
+        /\*\//, // SQL block comment end
+        /\$\{/, // Template literal injection
+        /\.\./, // Path traversal
+        /\|\|/, // Command injection
+        /<script/i, // XSS attempt
+        /javascript:/i, // JavaScript protocol
+        /data:/i, // Data URL
+        /&#/, // HTML entities
+        /=/, // Assignment/parameter pollution
+    ];
+    for (const pattern of dangerousPatterns) {
+        if (pattern.test(id)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Validates that a list ID is valid and safe to use
+ * Contains additional validation specific to Attio list IDs
+ *
+ * @param listId - The list ID to validate
+ * @returns True if the list ID is valid, false otherwise
+ */
+export function isValidListId(listId) {
+    // First apply general ID validation
+    if (!isValidId(listId)) {
+        return false;
+    }
+    // Additional validation specific to list IDs
+    // Attio list IDs typically start with "list_" followed by alphanumeric characters
+    if (!/^list_[a-zA-Z0-9]+$/.test(listId)) {
+        return false;
+    }
+    // Ensure the ID isn't suspiciously long
+    if (listId.length > 50) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/dist/utils/value-matcher.d.ts

@@ -0,0 +1,58 @@
+export interface ValueMatch {
+    value: string;
+    similarity: number;
+}
+export interface ValueMatchResult {
+    exactMatch?: string;
+    suggestions: ValueMatch[];
+    bestMatch?: ValueMatch;
+}
+/**
+ * Configuration for value matching behavior
+ */
+export interface ValueMatchConfig {
+    /** Minimum similarity score to consider a match (0-1) */
+    minSimilarity?: number;
+    /** Maximum number of suggestions to return */
+    maxSuggestions?: number;
+    /** Whether to use case-sensitive matching */
+    caseSensitive?: boolean;
+}
+/**
+ * Find the best matching values from a list of valid options
+ *
+ * @param searchValue - The value to search for
+ * @param validValues - Array of valid values to match against
+ * @param config - Optional configuration for matching behavior
+ * @returns Match result with exact match or suggestions
+ */
+export declare function findBestValueMatch(searchValue: string, validValues: string[], config?: ValueMatchConfig): ValueMatchResult;
+/**
+ * Format a value match error message with suggestions
+ *
+ * @param fieldName - The field being searched
+ * @param searchValue - The value that was searched for
+ * @param matchResult - The match result with suggestions
+ * @returns Formatted error message
+ */
+export declare function formatValueMatchError(fieldName: string, searchValue: string, matchResult: ValueMatchResult): string;
+/**
+ * Check if a value contains a partial match
+ * Useful for "contains" type searches
+ *
+ * @param searchValue - The partial value to search for
+ * @param validValues - Array of valid values to check
+ * @param caseSensitive - Whether to use case-sensitive matching
+ * @returns Array of values that contain the search value
+ */
+export declare function findPartialMatches(searchValue: string, validValues: string[], caseSensitive?: boolean): string[];
+/**
+ * Get value suggestions for a field
+ * This could be extended to cache or fetch valid values from Attio
+ *
+ * @param fieldSlug - The field slug (e.g., 'type_persona')
+ * @param searchValue - The value being searched for
+ * @returns Array of suggested values or null if no suggestions available
+ */
+export declare function getValueSuggestions(fieldSlug: string, searchValue: string): Promise<ValueMatch[] | null>;
+//# sourceMappingURL=value-matcher.d.ts.map

package/dist/utils/value-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/value-matcher.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,gBAAgB,GACxB,gBAAgB,CAyClB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,GAC5B,MAAM,CAeR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,GAAE,OAAe,GAC7B,MAAM,EAAE,CASV;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CA+B9B"}

package/dist/utils/value-matcher.js

@@ -0,0 +1,131 @@
+/**
+ * Value matching utilities for fuzzy matching field values
+ * Uses string-similarity for intelligent suggestions when exact matches fail
+ */
+import stringSimilarity from 'string-similarity';
+const DEFAULT_CONFIG = {
+    minSimilarity: 0.4,
+    maxSuggestions: 3,
+    caseSensitive: false,
+};
+/**
+ * Find the best matching values from a list of valid options
+ *
+ * @param searchValue - The value to search for
+ * @param validValues - Array of valid values to match against
+ * @param config - Optional configuration for matching behavior
+ * @returns Match result with exact match or suggestions
+ */
+export function findBestValueMatch(searchValue, validValues, config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    // Normalize for comparison if not case sensitive
+    const normalizedSearch = mergedConfig.caseSensitive
+        ? searchValue
+        : searchValue.toLowerCase();
+    // Check for exact match first
+    const exactMatch = validValues.find((value) => {
+        const normalizedValue = mergedConfig.caseSensitive
+            ? value
+            : value.toLowerCase();
+        return normalizedValue === normalizedSearch;
+    });
+    if (exactMatch) {
+        return {
+            exactMatch,
+            suggestions: [],
+            bestMatch: { value: exactMatch, similarity: 1.0 },
+        };
+    }
+    // No exact match, find similar values
+    const matches = stringSimilarity.findBestMatch(searchValue, validValues);
+    // Filter and sort suggestions by similarity
+    const suggestions = matches.ratings
+        .filter((rating) => rating.rating >= mergedConfig.minSimilarity)
+        .sort((a, b) => b.rating - a.rating)
+        .slice(0, mergedConfig.maxSuggestions)
+        .map((rating) => ({
+        value: rating.target,
+        similarity: rating.rating,
+    }));
+    return {
+        suggestions,
+        bestMatch: suggestions[0],
+    };
+}
+/**
+ * Format a value match error message with suggestions
+ *
+ * @param fieldName - The field being searched
+ * @param searchValue - The value that was searched for
+ * @param matchResult - The match result with suggestions
+ * @returns Formatted error message
+ */
+export function formatValueMatchError(fieldName, searchValue, matchResult) {
+    let message = `'${searchValue}' not found as '${fieldName}'.`;
+    if (matchResult.bestMatch && matchResult.bestMatch.similarity >= 0.7) {
+        message += ` Did you mean '${matchResult.bestMatch.value}'?`;
+    }
+    else if (matchResult.suggestions.length > 0) {
+        message += ' Did you mean one of these?';
+        matchResult.suggestions.forEach((suggestion) => {
+            message += `\n  - ${suggestion.value} (${Math.round(suggestion.similarity * 100)}% match)`;
+        });
+    }
+    return message;
+}
+/**
+ * Check if a value contains a partial match
+ * Useful for "contains" type searches
+ *
+ * @param searchValue - The partial value to search for
+ * @param validValues - Array of valid values to check
+ * @param caseSensitive - Whether to use case-sensitive matching
+ * @returns Array of values that contain the search value
+ */
+export function findPartialMatches(searchValue, validValues, caseSensitive = false) {
+    const normalizedSearch = caseSensitive
+        ? searchValue
+        : searchValue.toLowerCase();
+    return validValues.filter((value) => {
+        const normalizedValue = caseSensitive ? value : value.toLowerCase();
+        return normalizedValue.includes(normalizedSearch);
+    });
+}
+/**
+ * Get value suggestions for a field
+ * This could be extended to cache or fetch valid values from Attio
+ *
+ * @param fieldSlug - The field slug (e.g., 'type_persona')
+ * @param searchValue - The value being searched for
+ * @returns Array of suggested values or null if no suggestions available
+ */
+export async function getValueSuggestions(fieldSlug, searchValue) {
+    // This is where we could integrate with Attio API to fetch valid values
+    // For now, we'll use known values from our documentation
+    const knownValues = {
+        type_persona: [
+            'Plastic Surgeon',
+            'Medical Spa/Aesthetics',
+            'Dermatologist',
+            'Medical Practice',
+            'Wellness Center',
+            'Cosmetic Surgery',
+            'Aesthetic Medicine',
+        ],
+        industry: [
+            'Healthcare',
+            'Technology',
+            'Finance',
+            'Education',
+            'Retail',
+            'Manufacturing',
+        ],
+    };
+    const validValues = knownValues[fieldSlug];
+    if (!validValues) {
+        return null;
+    }
+    const matchResult = findBestValueMatch(searchValue, validValues);
+    return matchResult.suggestions;
+}
+//# sourceMappingURL=value-matcher.js.map

package/dist/utils/value-matcher.js.map

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

package/dist/validators/attribute-validator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Validation for Attio attribute types
+ * Provides validation and type conversion for attribute values
+ * to ensure they match Attio's expected types
+ *
+ * This module handles both validation and automatic type conversion
+ * for common data format mismatches, which is particularly useful for
+ * LLM-generated content where string representations of other data types
+ * are common.
+ */
+/**
+ * Supported attribute types in Attio
+ */
+export type AttributeType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'select' | 'record-reference';
+/**
+ * Result of attribute validation
+ */
+export interface ValidationResult {
+    /** Whether the validation was successful */
+    valid: boolean;
+    /** The converted value (may differ from input if type conversion was applied) */
+    convertedValue?: any;
+    /** Error message if validation failed */
+    error?: string;
+}
+/**
+ * Validates an attribute value against the expected type
+ *
+ * This function validates that a value matches the expected attribute type,
+ * and attempts to convert it when possible. It handles both strict validation
+ * and auto-conversion for common type mismatches.
+ *
+ * @param attributeName - The name of the attribute being validated
+ * @param value - The value to validate
+ * @param expectedType - The expected attribute type
+ * @returns Validation result with success status and optionally converted value
+ *
+ * @example
+ * // Validate a string
+ * validateAttributeValue('company_name', 'Acme Inc', 'string')
+ * // Returns: { valid: true, convertedValue: 'Acme Inc' }
+ *
+ * @example
+ * // Convert string to number
+ * validateAttributeValue('employee_count', '250', 'number')
+ * // Returns: { valid: true, convertedValue: 250 }
+ *
+ * @example
+ * // Convert string to boolean
+ * validateAttributeValue('is_active', 'yes', 'boolean')
+ * // Returns: { valid: true, convertedValue: true }
+ *
+ * @example
+ * // Handle invalid values
+ * validateAttributeValue('revenue', 'not-a-number', 'number')
+ * // Returns: { valid: false, error: 'Invalid number value...' }
+ */
+export declare function validateAttributeValue(attributeName: string, value: any, expectedType: AttributeType): ValidationResult;
+//# sourceMappingURL=attribute-validator.d.ts.map

package/dist/validators/attribute-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-validator.d.ts","sourceRoot":"","sources":["../../src/validators/attribute-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,iFAAiF;IACjF,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,GAAG,EACV,YAAY,EAAE,aAAa,GAC1B,gBAAgB,CA4BlB"}