@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,42 @@
+/**
+ * Email Validation Configuration
+ *
+ * Provides configurable email validation behavior to support backward compatibility
+ * while transitioning to stricter validation.
+ */
+/**
+ * Email validation mode options
+ */
+export declare enum EmailValidationMode {
+    /** Strict mode: Throw errors for invalid emails (default, recommended) */
+    STRICT = "strict",
+    /** Legacy mode: Silently skip invalid emails (backward compatibility) */
+    LEGACY = "legacy",
+    /** Warn mode: Log warnings for invalid emails but don't throw (transition mode) */
+    WARN = "warn"
+}
+/**
+ * Email validation configuration options
+ */
+export interface EmailValidationConfig {
+    /** Validation mode to use */
+    mode: EmailValidationMode;
+    /** Whether to log deprecation warnings for legacy mode usage */
+    logDeprecationWarnings?: boolean;
+    /** Custom logger function for warnings */
+    logger?: (message: string, level: 'warn' | 'error' | 'info') => void;
+}
+export declare const DEFAULT_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Legacy email validation configuration for backward compatibility
+ */
+export declare const LEGACY_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Warn mode configuration for gradual migration
+ */
+export declare const WARN_EMAIL_VALIDATION_CONFIG: EmailValidationConfig;
+/**
+ * Get validation config based on environment or explicit mode
+ */
+export declare function getEmailValidationConfig(explicitMode?: EmailValidationMode): EmailValidationConfig;
+//# sourceMappingURL=email-validation-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation-config.d.ts","sourceRoot":"","sources":["../../../src/utils/normalization/email-validation-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,0EAA0E;IAC1E,MAAM,WAAW;IAEjB,yEAAyE;IACzE,MAAM,WAAW;IAEjB,mFAAmF;IACnF,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAE1B,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CACtE;AAQD,eAAO,MAAM,+BAA+B,EAAE,qBAkB7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAkB5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,qBAkB1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,CAAC,EAAE,mBAAmB,GACjC,qBAAqB,CAmBvB"}

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

@@ -0,0 +1,107 @@
+/**
+ * Email Validation Configuration
+ *
+ * Provides configurable email validation behavior to support backward compatibility
+ * while transitioning to stricter validation.
+ */
+/**
+ * Email validation mode options
+ */
+export var EmailValidationMode;
+(function (EmailValidationMode) {
+    /** Strict mode: Throw errors for invalid emails (default, recommended) */
+    EmailValidationMode["STRICT"] = "strict";
+    /** Legacy mode: Silently skip invalid emails (backward compatibility) */
+    EmailValidationMode["LEGACY"] = "legacy";
+    /** Warn mode: Log warnings for invalid emails but don't throw (transition mode) */
+    EmailValidationMode["WARN"] = "warn";
+})(EmailValidationMode || (EmailValidationMode = {}));
+/**
+ * Default email validation configuration
+ */
+import { createScopedLogger } from '../logger.js';
+const evLogger = createScopedLogger('utils.email-validation', 'config');
+export const DEFAULT_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.STRICT,
+    logDeprecationWarnings: true,
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Legacy email validation configuration for backward compatibility
+ */
+export const LEGACY_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.LEGACY,
+    logDeprecationWarnings: true,
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Warn mode configuration for gradual migration
+ */
+export const WARN_EMAIL_VALIDATION_CONFIG = {
+    mode: EmailValidationMode.WARN,
+    logDeprecationWarnings: false, // Warnings are already being generated
+    logger: (message, level) => {
+        switch (level) {
+            case 'warn':
+                evLogger.warn(message);
+                break;
+            case 'error':
+                evLogger.error(message);
+                break;
+            case 'info':
+                evLogger.info(message);
+                break;
+            default:
+                evLogger.warn(message);
+        }
+    },
+};
+/**
+ * Get validation config based on environment or explicit mode
+ */
+export function getEmailValidationConfig(explicitMode) {
+    // Allow environment variable override for easier migration
+    const envMode = process.env.EMAIL_VALIDATION_MODE;
+    if (explicitMode) {
+        return {
+            ...DEFAULT_EMAIL_VALIDATION_CONFIG,
+            mode: explicitMode,
+        };
+    }
+    if (envMode && Object.values(EmailValidationMode).includes(envMode)) {
+        return {
+            ...DEFAULT_EMAIL_VALIDATION_CONFIG,
+            mode: envMode,
+        };
+    }
+    return DEFAULT_EMAIL_VALIDATION_CONFIG;
+}
+//# sourceMappingURL=email-validation-config.js.map

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

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

package/dist/utils/normalization/people-normalization.d.ts

@@ -0,0 +1,100 @@
+/**
+ * People Input Normalization
+ *
+ * Handles normalization of people data to support multiple input formats.
+ * Converts various input shapes to the standard Attio API format.
+ */
+import { EmailValidationConfig } from './email-validation-config.js';
+/**
+ * People name input formats
+ */
+export interface NameStringInput {
+    name: string;
+}
+export interface NameObjectInput {
+    first_name?: string;
+    last_name?: string;
+    full_name?: string;
+}
+export type NameInput = string | NameStringInput | NameObjectInput;
+/**
+ * Email input formats
+ */
+export type EmailInput = string | string[] | {
+    email_address: string;
+} | {
+    email_addresses: string[];
+};
+/**
+ * Normalized people data
+ */
+export interface NormalizedPeopleData {
+    first_name?: string;
+    last_name?: string;
+    full_name?: string;
+    email_addresses?: Array<{
+        email_address: string;
+        email_type?: string;
+    }>;
+    phone_numbers?: Array<{
+        phone_number: string;
+        phone_type?: string;
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Normalizes people input data to standard format
+ */
+export declare class PeopleDataNormalizer {
+    /**
+     * Normalize name input to standard format
+     */
+    static normalizeName(input: unknown, options?: {
+        includeFullName?: boolean;
+    }): {
+        first_name?: string;
+        last_name?: string;
+        full_name?: string;
+    } | undefined;
+    /**
+     * Extract email value from various input formats
+     */
+    private static extractEmailValue;
+    /**
+     * Validate and process a single email based on configuration
+     */
+    private static validateAndProcessEmail;
+    /**
+     * Normalize email input to standard format
+     *
+     * @param input - Email input in various formats
+     * @param config - Email validation configuration (optional)
+     */
+    static normalizeEmails(input: unknown, config?: EmailValidationConfig): Array<{
+        email_address: string;
+        email_type?: string;
+    }> | undefined;
+    /**
+     * Normalize phone number input
+     */
+    static normalizePhones(input: unknown): Array<{
+        phone_number: string;
+        phone_type?: string;
+    }> | undefined;
+    /**
+     * Normalize a single phone number
+     */
+    private static normalizePhoneNumber;
+    /**
+     * Normalize complete people record data
+     *
+     * @param data - People data to normalize
+     * @param emailConfig - Email validation configuration (optional)
+     */
+    static normalizePeopleData(data: unknown, emailConfig?: EmailValidationConfig): NormalizedPeopleData;
+    /**
+     * Check if data needs people normalization
+     */
+    static needsNormalization(data: unknown): boolean;
+}
+//# sourceMappingURL=people-normalization.d.ts.map

package/dist/utils/normalization/people-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people-normalization.d.ts","sourceRoot":"","sources":["../../../src/utils/normalization/people-normalization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EACL,qBAAqB,EAGtB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,EAAE,GACR;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAErC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,SAAS;IAiHb;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAyBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA2DtC;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,qBAAuD,GAC9D,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAsJpE;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,OAAO,GACb,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IA6EnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsBnC;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,OAAO,EACb,WAAW,GAAE,qBAAuD,GACnE,oBAAoB;IAoGvB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAoBlD"}