@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/type-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extraction.d.ts","sourceRoot":"","sources":["../../src/utils/type-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2BH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwCpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,GAAG,EAAE,OAAO,EACZ,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,CAAC,GAAG,SAAS,CAef;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAchC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,GAAG,EAAE,OAAO,EACZ,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,CAAC,EAAE,GAAG,SAAS,CAGjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAGzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,CAGR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,CAGR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,MAAM,EAAE,GACtB,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOhC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,SAAI,GAAG,KAAK,IAAI,CAAC,EAAE,CAE3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAC1D,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAYA"}

package/dist/utils/type-extraction.js

@@ -0,0 +1,358 @@
+/**
+ * Type-safe utility functions for extracting nested values from complex object structures
+ *
+ * **Issue #679 Implementation:**
+ * Addresses complex nested type assertions that appear throughout the services directory
+ * and hurt code readability. Provides clean, type-safe alternatives to patterns like:
+ * `((rec as Record<string, unknown>)?.id as Record<string, unknown>)?.record_id`
+ *
+ * **Performance Notes:**
+ * - Functions are optimized for readability over raw performance
+ * - For hot paths with frequent access, consider caching results
+ * - Debug logging only active in development mode for performance
+ */
+/**
+ * Debug logger for type extraction operations
+ * Only logs in development environment to avoid performance impact
+ */
+function debugTypeExtraction(operation, input, result, error) {
+    /* istanbul ignore next */
+    if (process.env.NODE_ENV === 'development' &&
+        process.env.TYPE_EXTRACTION_DEBUG === 'true') {
+        console.warn(`[TypeExtraction] ${operation}:`, {
+            inputType: typeof input,
+            resultType: typeof result,
+            hasResult: result !== undefined,
+            error,
+            timestamp: Date.now(),
+        });
+    }
+}
+/**
+ * Safely extracts record_id from nested object structures
+ * Handles the common pattern: obj?.id?.record_id with proper type safety
+ *
+ * @param obj - Object that may contain nested id.record_id structure
+ * @returns The record_id string or undefined if not found
+ *
+ * @example
+ * // Before (complex):
+ * // const recordId = ((rec as Record<string, unknown>)?.id as Record<string, unknown>)?.record_id as string;
+ *
+ * // After (clean):
+ * const recordId = safeExtractRecordId(rec);
+ * if (recordId) {
+ *   // Use recordId safely
+ * }
+ */
+export function safeExtractRecordId(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        debugTypeExtraction('safeExtractRecordId', obj, undefined, 'Input not an object');
+        return undefined;
+    }
+    const record = obj;
+    const idField = record.id;
+    if (typeof idField !== 'object' || idField === null) {
+        debugTypeExtraction('safeExtractRecordId', obj, undefined, 'id field not an object');
+        return undefined;
+    }
+    const idObject = idField;
+    const recordId = idObject.record_id;
+    const result = typeof recordId === 'string' ? recordId : undefined;
+    if (result === undefined && recordId !== undefined) {
+        debugTypeExtraction('safeExtractRecordId', obj, undefined, `record_id is ${typeof recordId}, not string`);
+    }
+    else {
+        debugTypeExtraction('safeExtractRecordId', obj, result);
+    }
+    return result;
+}
+/**
+ * Safely extracts the id object from a record
+ * Handles the pattern: obj?.id with proper type safety
+ *
+ * @param obj - Object that may contain an id field
+ * @returns The id object or undefined if not found
+ *
+ * @example
+ * // Before (complex):
+ * // const idObj = (rec as Record<string, unknown>)?.id as Record<string, unknown>;
+ *
+ * // After (clean):
+ * const idObj = safeExtractIdObject(rec);
+ * if (idObj?.record_id) {
+ *   // Use idObj safely
+ * }
+ */
+export function safeExtractIdObject(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return undefined;
+    }
+    const record = obj;
+    const idField = record.id;
+    if (typeof idField !== 'object' || idField === null) {
+        return undefined;
+    }
+    return idField;
+}
+/**
+ * Safely extracts nested property values with type safety
+ * Handles patterns like: obj?.values?.propertyName with multiple levels
+ *
+ * @param obj - Object to extract from
+ * @param path - Array of property names to traverse
+ * @returns The extracted value or undefined if path is invalid
+ *
+ * @example
+ * // Before (complex):
+ * // const name = ((rec as Record<string, unknown>)?.values as Record<string, unknown>)?.name;
+ *
+ * // After (clean with type inference):
+ * const name = safeExtractNestedValue<string>(rec, 'values', 'name');
+ * const domains = safeExtractNestedValue<string[]>(rec, 'values', 'domains');
+ * const count = safeExtractNestedValue<number>(rec, 'data', 'count');
+ *
+ * // Generic type parameter provides better IntelliSense and type safety
+ */
+export function safeExtractNestedValue(obj, ...path) {
+    if (typeof obj !== 'object' || obj === null) {
+        return undefined;
+    }
+    let current = obj;
+    for (const key of path) {
+        if (typeof current !== 'object' || current === null) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Safely extracts values object from a record
+ * Handles the pattern: obj?.values with proper type safety
+ *
+ * @param obj - Object that may contain a values field
+ * @returns The values object or undefined if not found
+ *
+ * @example
+ * // Before (complex):
+ * // const values = (rec as Record<string, unknown>)?.values as Record<string, unknown>;
+ *
+ * // After (clean):
+ * const values = safeExtractValuesObject(rec);
+ * if (values?.name) {
+ *   // Use values safely
+ * }
+ */
+export function safeExtractValuesObject(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return undefined;
+    }
+    const record = obj;
+    const valuesField = record.values;
+    if (typeof valuesField !== 'object' || valuesField === null) {
+        return undefined;
+    }
+    return valuesField;
+}
+/**
+ * Safely checks if a record has a valid record_id
+ * Combines existence check with type safety for common validation pattern
+ *
+ * @param obj - Object to check
+ * @returns True if object has a valid string record_id
+ *
+ * @example
+ * // Before (complex):
+ * // const isValid = !!(((record as Record<string, unknown>)?.id as Record<string, unknown>)?.record_id);
+ *
+ * // After (clean):
+ * const isValid = hasValidRecordId(record);
+ * if (!isValid) {
+ *   // Handle missing record_id
+ * }
+ */
+export function hasValidRecordId(obj) {
+    const recordId = safeExtractRecordId(obj);
+    return typeof recordId === 'string' && recordId.length > 0;
+}
+/**
+ * Type guard to check if an object looks like an Attio record
+ * Provides runtime type checking for record-like structures
+ *
+ * @param obj - Object to check
+ * @returns True if object has the expected record structure
+ *
+ * @example
+ * if (isAttioRecordLike(response)) {
+ *   const recordId = safeExtractRecordId(response);
+ *   // TypeScript knows this is safe
+ * }
+ */
+export function isAttioRecordLike(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const record = obj;
+    if (!('id' in record)) {
+        return false;
+    }
+    const idField = record.id;
+    return (typeof idField === 'object' && idField !== null && !Array.isArray(idField));
+}
+/**
+ * Safely extracts an array from a nested object path with type safety
+ * Handles the common pattern: Array.isArray(obj?.values?.field) && obj.values.field
+ *
+ * @param obj - Object to extract from
+ * @param path - Array of property names to traverse to the array field
+ * @returns The array or undefined if path is invalid or not an array
+ *
+ * @example
+ * // Before (complex):
+ * // const domains = Array.isArray(record.values?.domains) ? record.values.domains : undefined;
+ *
+ * // After (clean):
+ * const domains = safeExtractArray<string>(record, 'values', 'domains');
+ * const tags = safeExtractArray<string>(record, 'data', 'tags');
+ */
+export function safeExtractArray(obj, ...path) {
+    const value = safeExtractNestedValue(obj, ...path);
+    return Array.isArray(value) ? value : undefined;
+}
+/**
+ * Type guard to check if a nested field is an array with optional type checking
+ * Provides runtime validation for array fields in nested objects
+ *
+ * @param obj - Object to check
+ * @param path - Array of property names to traverse to the field
+ * @returns True if the nested field is an array
+ *
+ * @example
+ * // Before (complex):
+ * // if (Array.isArray(((record as Record<string, unknown>)?.values as Record<string, unknown>)?.domains)) {
+ *
+ * // After (clean):
+ * if (safeIsArrayField(record, 'values', 'domains')) {
+ *   // TypeScript knows domains is an array
+ *   const domains = safeExtractArray<string>(record, 'values', 'domains');
+ * }
+ */
+export function safeIsArrayField(obj, ...path) {
+    const value = safeExtractNestedValue(obj, ...path);
+    return Array.isArray(value);
+}
+/**
+ * Safely extracts a string value from nested object with fallback
+ * Common pattern for extracting string fields with default values
+ *
+ * @param obj - Object to extract from
+ * @param fallback - Default value if extraction fails
+ * @param path - Array of property names to traverse
+ * @returns The string value or fallback
+ *
+ * @example
+ * const name = safeExtractString(record, 'Unknown', 'values', 'name');
+ * const title = safeExtractString(task, 'Untitled', 'data', 'title');
+ */
+export function safeExtractString(obj, fallback, ...path) {
+    const value = safeExtractNestedValue(obj, ...path);
+    return typeof value === 'string' ? value : fallback;
+}
+/**
+ * Safely extracts a number value from nested object with fallback
+ * Common pattern for extracting numeric fields with default values
+ *
+ * @param obj - Object to extract from
+ * @param fallback - Default value if extraction fails
+ * @param path - Array of property names to traverse
+ * @returns The number value or fallback
+ *
+ * @example
+ * const count = safeExtractNumber(record, 0, 'data', 'count');
+ * const priority = safeExtractNumber(task, 1, 'values', 'priority');
+ */
+export function safeExtractNumber(obj, fallback, ...path) {
+    const value = safeExtractNestedValue(obj, ...path);
+    return typeof value === 'number' ? value : fallback;
+}
+/**
+ * Enhanced type guard for validating object structure with specific properties
+ * Provides runtime validation for complex object structures
+ *
+ * @param obj - Object to validate
+ * @param requiredProps - Array of required property names
+ * @returns True if object has all required properties
+ *
+ * @example
+ * if (hasRequiredProperties(record, ['id', 'values'])) {
+ *   // TypeScript knows record has id and values properties
+ *   const recordId = safeExtractRecordId(record);
+ * }
+ */
+export function hasRequiredProperties(obj, requiredProps) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const record = obj;
+    return requiredProps.every((prop) => prop in record);
+}
+/**
+ * Type guard to check if a value is a non-empty string
+ * Useful for validating string fields that shouldn't be empty
+ *
+ * @param value - Value to check
+ * @returns True if value is a non-empty string
+ *
+ * @example
+ * const name = safeExtractString(record, '', 'values', 'name');
+ * if (isNonEmptyString(name)) {
+ *   // TypeScript knows name is a non-empty string
+ *   console.log(name.toUpperCase());
+ * }
+ */
+export function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Type guard to check if a value is a valid array with minimum length
+ * Provides runtime validation for arrays with length constraints
+ *
+ * @param value - Value to check
+ * @param minLength - Minimum required length (default: 1)
+ * @returns True if value is an array with at least minLength items
+ *
+ * @example
+ * const domains = safeExtractArray<string>(record, 'values', 'domains');
+ * if (isValidArray(domains, 1)) {
+ *   // TypeScript knows domains is a non-empty array
+ *   domains.forEach(domain => console.log(domain));
+ * }
+ */
+export function isValidArray(value, minLength = 1) {
+    return Array.isArray(value) && value.length >= minLength;
+}
+/**
+ * Advanced type guard for Attio record validation with strict checking
+ * Validates that an object has the complete Attio record structure
+ *
+ * @param obj - Object to validate
+ * @returns True if object is a complete Attio record
+ *
+ * @example
+ * if (isCompleteAttioRecord(response)) {
+ *   // TypeScript knows this has id.record_id and values
+ *   const recordId = safeExtractRecordId(response); // guaranteed to be string
+ *   const values = safeExtractValuesObject(response); // guaranteed to be object
+ * }
+ */
+export function isCompleteAttioRecord(obj) {
+    if (!isAttioRecordLike(obj)) {
+        return false;
+    }
+    const record = obj;
+    const recordId = safeExtractRecordId(record);
+    const values = safeExtractValuesObject(record);
+    return (isNonEmptyString(recordId) && typeof values === 'object' && values !== null);
+}
+//# sourceMappingURL=type-extraction.js.map

package/dist/utils/type-extraction.js.map

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

package/dist/utils/types/common.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Common reusable type aliases for data handling and API operations
+ */
+/**
+ * Generic object with unknown values - safe alternative to 'any'
+ * Use for API responses, configuration objects, and data transformation
+ */
+export type UnknownObject = Record<string, unknown>;
+/**
+ * Filter object used in API queries and data filtering operations
+ * Typically contains field names as keys with filter criteria as values
+ */
+export type FilterObject = Record<string, unknown>;
+/**
+ * API response data structure with unknown content
+ * Use for raw API responses before type validation
+ */
+export type ApiResponseData = Record<string, unknown>;
+/**
+ * Configuration object with string keys and unknown values
+ * Use for settings, options, and configuration parameters
+ */
+export type ConfigObject = Record<string, unknown>;
+/**
+ * Generic data transformation input/output
+ * Use in normalization and mapping functions
+ */
+export type DataObject = Record<string, unknown>;
+/**
+ * Error context object for error handling and enhancement
+ * Contains error metadata and debugging information
+ */
+export type ErrorContext = Record<string, unknown>;
+/**
+ * Logging metadata object for structured logging
+ * Contains additional context for log entries
+ */
+export type LogMetadata = Record<string, unknown>;
+//# sourceMappingURL=common.d.ts.map

package/dist/utils/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/utils/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/utils/types/common.js

@@ -0,0 +1,5 @@
+/**
+ * Common reusable type aliases for data handling and API operations
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/utils/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/utils/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/uri-parser.d.ts

@@ -0,0 +1,18 @@
+import { ResourceType } from '../types/attio.js';
+/**
+ * Parse an Attio resource URI into resource type and ID
+ *
+ * @param uri - The URI to parse (format: attio://{type}/{id})
+ * @returns Tuple of [resourceType, resourceId]
+ * @throws Error if URI format is invalid
+ */
+export declare function parseResourceUri(uri: string): [ResourceType, string];
+/**
+ * Creates an Attio resource URI from a type and ID
+ *
+ * @param type - The resource type
+ * @param id - The resource ID
+ * @returns Formatted URI
+ */
+export declare function formatResourceUri(type: ResourceType, id: string): string;
+//# sourceMappingURL=uri-parser.d.ts.map

package/dist/utils/uri-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-parser.d.ts","sourceRoot":"","sources":["../../src/utils/uri-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAepE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/utils/uri-parser.js

@@ -0,0 +1,31 @@
+import { ResourceType } from '../types/attio.js';
+/**
+ * Parse an Attio resource URI into resource type and ID
+ *
+ * @param uri - The URI to parse (format: attio://{type}/{id})
+ * @returns Tuple of [resourceType, resourceId]
+ * @throws Error if URI format is invalid
+ */
+export function parseResourceUri(uri) {
+    const match = uri.match(/^attio:\/\/([^/]+)\/(.+)$/);
+    if (!match) {
+        throw new Error(`Invalid resource URI format: ${uri}`);
+    }
+    const [, typeStr, id] = match;
+    // Validate resource type
+    if (!Object.values(ResourceType).includes(typeStr)) {
+        throw new Error(`Unsupported resource type: ${typeStr}`);
+    }
+    return [typeStr, id];
+}
+/**
+ * Creates an Attio resource URI from a type and ID
+ *
+ * @param type - The resource type
+ * @param id - The resource ID
+ * @returns Formatted URI
+ */
+export function formatResourceUri(type, id) {
+    return `attio://${type}/${id}`;
+}
+//# sourceMappingURL=uri-parser.js.map

package/dist/utils/uri-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-parser.js","sourceRoot":"","sources":["../../src/utils/uri-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAErD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IAE9B,yBAAyB;IACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAuB,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,CAAC,OAAuB,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB,EAAE,EAAU;IAC9D,OAAO,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC;AACjC,CAAC"}

package/dist/utils/validation/email-validation.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Email validation utilities for the Attio MCP Server
+ *
+ * Provides RFC 5322 compliant email validation that is consistent
+ * across the application. This replaces the inconsistent simple regex
+ * patterns that were scattered throughout the codebase.
+ */
+/**
+ * Validates an email address according to RFC 5322 with practical limitations
+ *
+ * This validation is more comprehensive than the previous simple regex and handles:
+ * - International domains
+ * - Plus addressing (user+tag@domain.com)
+ * - Multiple subdomains
+ * - TLDs from 2 to 63 characters
+ * - Proper length limits per RFC 5321
+ *
+ * @param email - The email address to validate
+ * @returns true if the email is valid, false otherwise
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates an array of email addresses
+ *
+ * @param emails - Array of email addresses to validate
+ * @returns An object with valid and invalid email arrays
+ */
+export declare function validateEmails(emails: string[]): {
+    valid: string[];
+    invalid: string[];
+};
+/**
+ * Normalizes an email address to lowercase
+ * Note: Only the domain part should be normalized to lowercase per RFC.
+ * The local part (before @) is case-sensitive per spec, but most
+ * email providers treat it as case-insensitive.
+ *
+ * @param email - Email address to normalize
+ * @returns Normalized email address or null if invalid
+ */
+export declare function normalizeEmail(email: string): string | null;
+/**
+ * Extracts the domain from an email address
+ *
+ * @param email - Email address to extract domain from
+ * @returns Domain part of the email or null if invalid
+ */
+export declare function extractEmailDomain(email: string): string | null;
+//# sourceMappingURL=email-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/email-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAgEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAaA;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/D"}

package/dist/utils/validation/email-validation.js

@@ -0,0 +1,122 @@
+/**
+ * Email validation utilities for the Attio MCP Server
+ *
+ * Provides RFC 5322 compliant email validation that is consistent
+ * across the application. This replaces the inconsistent simple regex
+ * patterns that were scattered throughout the codebase.
+ */
+/**
+ * Validates an email address according to RFC 5322 with practical limitations
+ *
+ * This validation is more comprehensive than the previous simple regex and handles:
+ * - International domains
+ * - Plus addressing (user+tag@domain.com)
+ * - Multiple subdomains
+ * - TLDs from 2 to 63 characters
+ * - Proper length limits per RFC 5321
+ *
+ * @param email - The email address to validate
+ * @returns true if the email is valid, false otherwise
+ */
+export function isValidEmail(email) {
+    if (!email || typeof email !== 'string') {
+        return false;
+    }
+    // Trim whitespace
+    email = email.trim();
+    // Check for reasonable length limits (RFC 5321)
+    if (email.length === 0 || email.length > 254) {
+        return false;
+    }
+    // More comprehensive email validation regex based on RFC 5322
+    // This handles international domains, plus addressing, multiple subdomains, etc.
+    const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+    if (!emailRegex.test(email)) {
+        return false;
+    }
+    // Additional validation for edge cases
+    const parts = email.split('@');
+    if (parts.length !== 2) {
+        return false;
+    }
+    const [localPart, domain] = parts;
+    // Check local part length (before @) - RFC 5321 limit
+    if (localPart.length === 0 || localPart.length > 64) {
+        return false;
+    }
+    // Check for consecutive dots in local part (not allowed per RFC 5322)
+    if (localPart.includes('..')) {
+        return false;
+    }
+    // Local part cannot start or end with dot
+    if (localPart.startsWith('.') || localPart.endsWith('.')) {
+        return false;
+    }
+    // Check domain has at least one dot
+    if (!domain.includes('.')) {
+        return false;
+    }
+    // Check domain parts
+    const domainParts = domain.split('.');
+    for (const part of domainParts) {
+        // Each domain part should not be empty and should not exceed 63 characters
+        if (part.length === 0 || part.length > 63) {
+            return false;
+        }
+        // Domain parts should not start or end with hyphen
+        if (part.startsWith('-') || part.endsWith('-')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Validates an array of email addresses
+ *
+ * @param emails - Array of email addresses to validate
+ * @returns An object with valid and invalid email arrays
+ */
+export function validateEmails(emails) {
+    const valid = [];
+    const invalid = [];
+    for (const email of emails) {
+        if (isValidEmail(email)) {
+            valid.push(email);
+        }
+        else {
+            invalid.push(email);
+        }
+    }
+    return { valid, invalid };
+}
+/**
+ * Normalizes an email address to lowercase
+ * Note: Only the domain part should be normalized to lowercase per RFC.
+ * The local part (before @) is case-sensitive per spec, but most
+ * email providers treat it as case-insensitive.
+ *
+ * @param email - Email address to normalize
+ * @returns Normalized email address or null if invalid
+ */
+export function normalizeEmail(email) {
+    if (!isValidEmail(email)) {
+        return null;
+    }
+    // For practical purposes, convert entire email to lowercase
+    // as most email providers treat the local part as case-insensitive
+    return email.trim().toLowerCase();
+}
+/**
+ * Extracts the domain from an email address
+ *
+ * @param email - Email address to extract domain from
+ * @returns Domain part of the email or null if invalid
+ */
+export function extractEmailDomain(email) {
+    if (!isValidEmail(email)) {
+        return null;
+    }
+    const parts = email.split('@');
+    return parts[1].toLowerCase();
+}
+//# sourceMappingURL=email-validation.js.map

package/dist/utils/validation/email-validation.js.map

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