attio-mcp 0.1.1 → 1.0.0

package/dist/utils/batch-validation.js

@@ -0,0 +1,220 @@
+/**
+ * Batch operation validation utilities for DoS protection
+ *
+ * Provides comprehensive validation for batch operations including
+ * size limits, payload validation, and rate limiting checks.
+ */
+import { BATCH_SIZE_LIMITS, PAYLOAD_SIZE_LIMITS, LIMIT_ERROR_MESSAGES, getBatchSizeLimit, } from '../config/security-limits.js';
+import { ErrorType } from './error-handler.js';
+/**
+ * Calculate the approximate size of a JavaScript object in bytes
+ * This is used to estimate payload sizes for validation
+ */
+function getObjectSize(obj) {
+    let size = 0;
+    if (obj === null || obj === undefined) {
+        return 0;
+    }
+    if (typeof obj === 'string') {
+        return obj.length * 2; // Unicode characters can be up to 2 bytes
+    }
+    if (typeof obj === 'number') {
+        return 8; // Numbers are typically 8 bytes
+    }
+    if (typeof obj === 'boolean') {
+        return 4; // Booleans are typically 4 bytes
+    }
+    if (obj instanceof Date) {
+        return 8; // Dates are stored as numbers
+    }
+    if (Array.isArray(obj)) {
+        for (const item of obj) {
+            size += getObjectSize(item);
+        }
+        return size;
+    }
+    if (typeof obj === 'object') {
+        for (const [key, value] of Object.entries(obj)) {
+            size += key.length * 2; // Key size
+            size += getObjectSize(value); // Value size
+        }
+        return size;
+    }
+    return 0;
+}
+/**
+ * Validates the size of a batch operation
+ *
+ * @param items - Array of items in the batch
+ * @param operationType - Type of operation (create, update, delete, etc.)
+ * @param resourceType - Type of resource (companies, people, etc.)
+ * @returns Validation result
+ */
+export function validateBatchSize(items, operationType, resourceType) {
+    // Check if items is a valid array
+    if (!items || !Array.isArray(items)) {
+        return {
+            isValid: false,
+            error: 'Batch items must be a non-empty array',
+            errorType: ErrorType.VALIDATION_ERROR,
+        };
+    }
+    // Check for empty array
+    if (items.length === 0) {
+        return {
+            isValid: false,
+            error: 'Batch operation requires at least one item',
+            errorType: ErrorType.VALIDATION_ERROR,
+        };
+    }
+    // Get the appropriate size limit
+    let maxSize = getBatchSizeLimit(resourceType);
+    // Apply more restrictive limits for certain operations
+    if (operationType.toLowerCase() === 'delete') {
+        maxSize = Math.min(maxSize, BATCH_SIZE_LIMITS.DELETE);
+    }
+    else if (operationType.toLowerCase() === 'search') {
+        maxSize = Math.min(maxSize, BATCH_SIZE_LIMITS.SEARCH);
+    }
+    // Check if batch size exceeds limit
+    if (items.length > maxSize) {
+        return {
+            isValid: false,
+            error: LIMIT_ERROR_MESSAGES.BATCH_SIZE_EXCEEDED(items.length, maxSize, `${operationType} ${resourceType || ''}`.trim()),
+            errorType: ErrorType.VALIDATION_ERROR,
+            details: {
+                actualSize: items.length,
+                maxSize,
+            },
+        };
+    }
+    return { isValid: true };
+}
+/**
+ * Validates the payload size of a batch operation
+ *
+ * @param payload - The payload to validate
+ * @param checkSingleRecords - Whether to check individual record sizes
+ * @returns Validation result
+ */
+export function validatePayloadSize(payload, checkSingleRecords = true) {
+    // Calculate total payload size
+    const totalSize = getObjectSize(payload);
+    // Check total payload size
+    if (totalSize > PAYLOAD_SIZE_LIMITS.BATCH_TOTAL) {
+        return {
+            isValid: false,
+            error: LIMIT_ERROR_MESSAGES.PAYLOAD_SIZE_EXCEEDED(totalSize, PAYLOAD_SIZE_LIMITS.BATCH_TOTAL),
+            errorType: ErrorType.VALIDATION_ERROR,
+            details: {
+                payloadSize: totalSize,
+                maxPayloadSize: PAYLOAD_SIZE_LIMITS.BATCH_TOTAL,
+            },
+        };
+    }
+    // Check individual record sizes if requested
+    if (checkSingleRecords && Array.isArray(payload)) {
+        for (let i = 0; i < payload.length; i++) {
+            const recordSize = getObjectSize(payload[i]);
+            if (recordSize > PAYLOAD_SIZE_LIMITS.SINGLE_RECORD) {
+                return {
+                    isValid: false,
+                    error: `Record at index ${i}: ` +
+                        LIMIT_ERROR_MESSAGES.SINGLE_RECORD_SIZE_EXCEEDED(recordSize, PAYLOAD_SIZE_LIMITS.SINGLE_RECORD),
+                    errorType: ErrorType.VALIDATION_ERROR,
+                    details: {
+                        payloadSize: recordSize,
+                        maxPayloadSize: PAYLOAD_SIZE_LIMITS.SINGLE_RECORD,
+                    },
+                };
+            }
+        }
+    }
+    return { isValid: true };
+}
+/**
+ * Validates search query parameters
+ *
+ * @param query - Search query string
+ * @param filters - Optional filter object
+ * @returns Validation result
+ */
+export function validateSearchQuery(query, filters) {
+    // Validate query string length
+    if (query && query.length > PAYLOAD_SIZE_LIMITS.SEARCH_QUERY) {
+        return {
+            isValid: false,
+            error: LIMIT_ERROR_MESSAGES.SEARCH_QUERY_TOO_LONG(query.length, PAYLOAD_SIZE_LIMITS.SEARCH_QUERY),
+            errorType: ErrorType.VALIDATION_ERROR,
+        };
+    }
+    // Validate filter object size
+    if (filters) {
+        const filterSize = getObjectSize(filters);
+        if (filterSize > PAYLOAD_SIZE_LIMITS.FILTER_OBJECT) {
+            return {
+                isValid: false,
+                error: LIMIT_ERROR_MESSAGES.FILTER_TOO_COMPLEX(filterSize, PAYLOAD_SIZE_LIMITS.FILTER_OBJECT),
+                errorType: ErrorType.VALIDATION_ERROR,
+            };
+        }
+    }
+    return { isValid: true };
+}
+/**
+ * Comprehensive validation for batch operations
+ * Combines size, payload, and other validations
+ *
+ * @param params - Parameters object containing batch operation details
+ * @returns Validation result
+ */
+export function validateBatchOperation(params) {
+    const { items, operationType, resourceType, checkPayload = true } = params;
+    // Validate batch size
+    const sizeValidation = validateBatchSize(items, operationType, resourceType);
+    if (!sizeValidation.isValid) {
+        return sizeValidation;
+    }
+    // Validate payload size if requested
+    if (checkPayload && items) {
+        const payloadValidation = validatePayloadSize(items);
+        if (!payloadValidation.isValid) {
+            return payloadValidation;
+        }
+    }
+    return { isValid: true };
+}
+/**
+ * Splits a large batch into smaller chunks that respect size limits
+ *
+ * @param items - Array of items to split
+ * @param resourceType - Type of resource for determining limits
+ * @returns Array of batches
+ */
+export function splitBatchIntoChunks(items, resourceType) {
+    if (!items || items.length === 0) {
+        return [];
+    }
+    const maxSize = getBatchSizeLimit(resourceType);
+    const chunks = [];
+    for (let i = 0; i < items.length; i += maxSize) {
+        chunks.push(items.slice(i, i + maxSize));
+    }
+    return chunks;
+}
+/**
+ * Creates a safe error message for batch validation failures
+ * This ensures no sensitive information is exposed in error messages
+ *
+ * @param validation - Validation result
+ * @returns Safe error message
+ */
+export function createSafeBatchError(validation) {
+    if (validation.isValid) {
+        return '';
+    }
+    // Return the error message without exposing internal limits
+    // The error messages already handle this safely
+    return validation.error || 'Batch validation failed';
+}
+//# sourceMappingURL=batch-validation.js.map

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

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

package/dist/utils/cli-colors.d.ts

@@ -20,8 +20,8 @@ declare const colors: {
  *
  * @example
  * ```typescript
- * console.log(colorize('Success!', 'green'));
- * console.log(colorize('Warning', 'yellow'));
+ * console.error(colorize('Success!', 'green'));
+ * console.error(colorize('Warning', 'yellow'));
  * ```
  */
 export declare function colorize(text: string, color: keyof typeof colors): string;

package/dist/utils/cli-colors.js

@@ -21,8 +21,8 @@ const colors = {
  *
  * @example
  * ```typescript
- * console.log(colorize('Success!', 'green'));
- * console.log(colorize('Warning', 'yellow'));
+ * console.error(colorize('Success!', 'green'));
+ * console.error(colorize('Warning', 'yellow'));
  * ```
  */
 export function colorize(text, color) {

package/dist/utils/client-resolver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Type-safe client resolver for Attio API client factory methods
+ * Provides reliable fallbacks and rich diagnostics when resolution fails.
+ */
+import { AxiosInstance } from 'axios';
+/**
+ * Resolves an Attio client instance using the available factory methods.
+ * Prioritises getAttioClient() → createAttioClient() → buildAttioClient().
+ */
+export declare function resolveAttioClient(): AxiosInstance;
+/**
+ * Checks whether an arbitrary value looks like an Attio Axios client.
+ */
+export declare function isAttioClient(client: unknown): client is AxiosInstance;
+/**
+ * Resolves and validates the client, guaranteeing callers receive a proper
+ * Axios instance or a descriptive error.
+ */
+export declare function getValidatedAttioClient(): AxiosInstance;
+//# sourceMappingURL=client-resolver.d.ts.map

package/dist/utils/client-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA+CtC;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAsClD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}

package/dist/utils/client-resolver.js

@@ -0,0 +1,82 @@
+/**
+ * Type-safe client resolver for Attio API client factory methods
+ * Provides reliable fallbacks and rich diagnostics when resolution fails.
+ */
+import * as AttioClientModule from '../api/attio-client.js';
+import { getContextApiKey } from '../api/client-context.js';
+/**
+ * Collects available method names on the mocked or real module so error
+ * messages can help the caller understand why resolution failed.
+ */
+function getAvailableMethodNames(mod) {
+    return Object.keys(mod).filter((key) => typeof mod[key] === 'function');
+}
+/**
+ * Guards that the resolved value behaves like an Axios instance. We keep the
+ * checks intentionally simple so tests can provide lightweight mocks.
+ */
+function assertAxiosInstance(value, source) {
+    const candidate = value;
+    const hasGetMethod = !!candidate &&
+        typeof candidate === 'object' &&
+        typeof candidate.get === 'function';
+    const hasDefaults = hasGetMethod &&
+        'defaults' in candidate &&
+        typeof candidate.defaults === 'object';
+    if (!hasGetMethod || !hasDefaults) {
+        throw new Error(`${source} returned invalid Axios client instance`);
+    }
+}
+/**
+ * Resolves an Attio client instance using the available factory methods.
+ * Prioritises getAttioClient() → createAttioClient() → buildAttioClient().
+ */
+export function resolveAttioClient() {
+    const mod = AttioClientModule;
+    const resolvedApiKey = process.env.ATTIO_API_KEY || getContextApiKey();
+    if (typeof mod.getAttioClient === 'function') {
+        const client = mod.getAttioClient();
+        assertAxiosInstance(client, 'getAttioClient()');
+        return client;
+    }
+    if (typeof mod.createAttioClient === 'function') {
+        if (!resolvedApiKey) {
+            throw new Error('No available Attio client factory method found. Available methods: createAttioClient. Has API key: false');
+        }
+        const client = mod.createAttioClient(resolvedApiKey);
+        assertAxiosInstance(client, 'createAttioClient()');
+        return client;
+    }
+    if (typeof mod.buildAttioClient === 'function') {
+        if (!resolvedApiKey) {
+            throw new Error('No available Attio client factory method found. Available methods: buildAttioClient. Has API key: false');
+        }
+        const client = mod.buildAttioClient({ apiKey: resolvedApiKey });
+        assertAxiosInstance(client, 'buildAttioClient()');
+        return client;
+    }
+    const availableMethods = getAvailableMethodNames(mod);
+    throw new Error(`No available Attio client factory method found. Available methods: ${availableMethods.length > 0 ? availableMethods.join(', ') : 'none'}. Has API key: ${Boolean(resolvedApiKey)}`);
+}
+/**
+ * Checks whether an arbitrary value looks like an Attio Axios client.
+ */
+export function isAttioClient(client) {
+    try {
+        assertAxiosInstance(client, 'isAttioClient check');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolves and validates the client, guaranteeing callers receive a proper
+ * Axios instance or a descriptive error.
+ */
+export function getValidatedAttioClient() {
+    const client = resolveAttioClient();
+    assertAxiosInstance(client, 'getValidatedAttioClient()');
+    return client;
+}
+//# sourceMappingURL=client-resolver.js.map

package/dist/utils/client-resolver.js.map

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

package/dist/utils/config-loader.d.ts

@@ -3,7 +3,7 @@
  */
 export interface MappingConfig {
     version: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     mappings: {
         attributes: {
             common: Record<string, string>;
@@ -13,7 +13,7 @@ export interface MappingConfig {
         objects: Record<string, string>;
         lists: Record<string, string>;
         relationships: Record<string, string>;
-        [key: string]: any;
+        [key: string]: Record<string, unknown>;
     };
 }
 /**
@@ -37,5 +37,5 @@ export declare function writeMappingConfig(config: MappingConfig, filePath?: str
  * @param merge - Whether to merge with existing mappings (default: true)
  * @param filePath - The file path to write to (defaults to user.json)
  */
-export declare function updateMappingSection(section: string, mappings: Record<string, any>, merge?: boolean, filePath?: string): Promise<void>;
+export declare function updateMappingSection(section: string, mappings: Record<string, unknown>, merge?: boolean, filePath?: string): Promise<void>;
 //# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,EAAE;QACR,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAChC,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AA2FD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAiBjD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,KAAK,GAAE,OAAc,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE;QACR,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAChC,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACH;AA4KD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CA6BjD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,GAAE,OAAc,EACrB,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/utils/config-loader.js

@@ -2,38 +2,89 @@
  * Configuration loader for Attio MCP Server
  * Handles loading and merging of configuration files
  */
-import fs from 'fs';
-import path from 'path';
+import * as fs from 'fs';
+import * as path from 'path';
+import { createScopedLogger } from './logger.js';
+import { DANGEROUS_KEYS } from './security-constants.js';
 /**
  * Default paths for configuration files
  */
 const CONFIG_PATHS = {
-    default: path.resolve(process.cwd(), 'config/mappings/default.json'),
-    user: path.resolve(process.cwd(), 'config/mappings/user.json'),
+    default: path.resolve(process.cwd(), 'configs/runtime/mappings/default.json'),
+    user: path.resolve(process.cwd(), 'configs/runtime/mappings/user.json'),
 };
 /**
- * Deep merges two objects, with values from the source object taking precedence
+ * Validates that a key is safe for object property assignment
+ * Prevents prototype pollution attacks by filtering dangerous keys
+ *
+ * @param key - The property key to validate
+ * @returns True if the key is safe to use, false otherwise
+ */
+function isSafeKey(key) {
+    return (!DANGEROUS_KEYS.includes(key) && !key.includes('.'));
+}
+/**
+ * Type guard to validate if an object is a valid MappingConfig
+ * @param obj - Object to validate
+ * @returns True if the object is a valid MappingConfig
+ */
+function isValidMappingConfig(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'mappings' in obj &&
+        typeof obj.mappings === 'object');
+}
+/**
+ * Safely converts an object to MergeableObject for security processing
+ * @param obj - Object to convert
+ * @returns Converted object or empty object if invalid
+ */
+function toMergeableObject(obj) {
+    if (typeof obj === 'object' && obj !== null) {
+        return obj;
+    }
+    return {};
+}
+/**
+ * Validates section path parts for security risks
+ * @param sectionParts - Array of section path components to validate
+ * @throws Error if any part contains dangerous keys
+ */
+function validateSectionPath(sectionParts) {
+    const invalidPart = sectionParts.find((part) => !isSafeKey(part));
+    if (invalidPart) {
+        throw new Error(`Invalid section key detected: ${invalidPart}. This key poses a security risk.`);
+    }
+}
+/**
+ * Safely deep merges two objects, with values from the source object taking precedence
+ * Implements prototype pollution protection by filtering dangerous keys
  *
  * @param target - The target object
  * @param source - The source object to merge in
  * @returns The merged object
  */
-function deepMerge(target, source) {
+function safeMerge(target, source) {
     const result = { ...target };
     for (const key in source) {
+        // Security: Skip dangerous keys that could cause prototype pollution
+        if (!isSafeKey(key)) {
+            createScopedLogger('utils/config-loader', 'safeMerge').debug('Rejected dangerous key during merge', { key, source: 'config-loader' });
+            continue;
+        }
         if (Object.prototype.hasOwnProperty.call(source, key)) {
             if (source[key] &&
                 typeof source[key] === 'object' &&
                 !Array.isArray(source[key])) {
-                // If both target and source have an object at this key, merge them
+                // If both target and source have an object at this key, merge them recursively
                 if (result[key] &&
                     typeof result[key] === 'object' &&
                     !Array.isArray(result[key])) {
-                    result[key] = deepMerge(result[key], source[key]);
+                    result[key] = safeMerge(result[key], source[key]);
                 }
                 else {
-                    // Otherwise, just use the source value
-                    result[key] = { ...source[key] };
+                    // Otherwise, safely copy the source value
+                    result[key] = safeMerge({}, source[key]);
                 }
             }
             else {
@@ -74,6 +125,7 @@ function createEmptyConfig() {
  * @param filePath - Path to the JSON file
  * @returns Parsed JSON object, or null if the file doesn't exist
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- JSON.parse returns any by design, content structure is unknown
 function loadJsonFile(filePath) {
     try {
         if (fs.existsSync(filePath)) {
@@ -82,7 +134,10 @@ function loadJsonFile(filePath) {
         }
     }
     catch (error) {
-        console.warn(`Warning: Failed to load config file ${filePath}:`, error);
+        createScopedLogger('utils/config-loader', 'loadJsonFile').warn('Failed to load config file', {
+            filePath,
+            error: error instanceof Error ? error.message : String(error),
+        });
     }
     return null;
 }
@@ -97,12 +152,18 @@ export function loadMappingConfig() {
     // Load and merge the default configuration
     const defaultConfig = loadJsonFile(CONFIG_PATHS.default);
     if (defaultConfig) {
-        config = deepMerge(config, defaultConfig);
+        const mergedConfig = safeMerge(toMergeableObject(config), toMergeableObject(defaultConfig));
+        if (isValidMappingConfig(mergedConfig)) {
+            config = mergedConfig;
+        }
     }
     // Load and merge the user configuration
     const userConfig = loadJsonFile(CONFIG_PATHS.user);
     if (userConfig) {
-        config = deepMerge(config, userConfig);
+        const mergedConfig = safeMerge(toMergeableObject(config), toMergeableObject(userConfig));
+        if (isValidMappingConfig(mergedConfig)) {
+            config = mergedConfig;
+        }
     }
     return config;
 }
@@ -146,6 +207,8 @@ export async function updateMappingSection(section, mappings, merge = true, file
     // Parse the section path and navigate to the target section
     const sectionParts = section.split('.');
     let target = config.mappings;
+    // Security: Validate all section parts for prototype pollution safety
+    validateSectionPath(sectionParts);
     for (let i = 0; i < sectionParts.length - 1; i++) {
         const part = sectionParts[i];
         if (!target[part]) {
@@ -154,12 +217,16 @@ export async function updateMappingSection(section, mappings, merge = true, file
         target = target[part];
     }
     const finalPart = sectionParts[sectionParts.length - 1];
-    // Update the target section
+    // Update the target section with security validation
     if (merge && target[finalPart]) {
-        target[finalPart] = { ...target[finalPart], ...mappings };
+        // Use safe merging for existing sections
+        const mergedSection = safeMerge(toMergeableObject(target[finalPart]), toMergeableObject(mappings));
+        target[finalPart] = mergedSection;
     }
     else {
-        target[finalPart] = mappings;
+        // For new sections, ensure the mappings object is safe
+        const safeSection = safeMerge({}, toMergeableObject(mappings));
+        target[finalPart] = safeSection;
     }
     // Write the updated config
     await writeMappingConfig(config, filePath);

package/dist/utils/config-loader.js.map

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

package/dist/utils/config-migration.d.ts

@@ -29,7 +29,7 @@ export interface MigrationDetection {
  * ```typescript
  * const detection = detectMigrationNeeds();
  * if (detection.needsMigration) {
- *   console.log('Found outdated mappings:', detection.outdatedMappings);
+ *   console.error('Found outdated mappings:', detection.outdatedMappings);
  * }
  * ```
  */
@@ -49,7 +49,7 @@ export declare function detectMigrationNeeds(): MigrationDetection;
  * ```typescript
  * const backup = createBackup();
  * if (backup.success) {
- *   console.log('Backup created at:', backup.backupPath);
+ *   console.error('Backup created at:', backup.backupPath);
  * } else {
  *   console.error('Backup failed:', backup.error);
  * }
@@ -80,8 +80,8 @@ export declare function createBackup(): {
  * ```typescript
  * const result = applyMigration();
  * if (result.success) {
- *   console.log('Migration completed:', result.message);
- *   console.log('Changes:', result.changesApplied);
+ *   console.error('Migration completed:', result.message);
+ *   console.error('Changes:', result.changesApplied);
  * } else {
  *   console.error('Migration failed:', result.message);
  * }
@@ -125,12 +125,12 @@ export declare function validateMigration(): {
  * ```typescript
  * // Preview changes without applying
  * const preview = migrateUserConfig({ dryRun: true });
- * console.log('Would apply:', preview.changesApplied);
+ * console.error('Would apply:', preview.changesApplied);
  *
  * // Apply the migration
  * const result = migrateUserConfig();
  * if (result.success) {
- *   console.log('Migration completed successfully');
+ *   console.error('Migration completed successfully');
  * }
  * ```
  */