Method deepMerge

server/modules/configModule.js:115–162

* Deep merge two objects, preserving existing values and adding missing ones from template * Handles nested objects recursively * @param {object} template - Template object with all possible fields * @param {object} existing - Existing object with user values * @param {string} path - Cur

(template, existing, path = '')

   * @returns {object} Object with { merged, fieldsAdded: string[] }
   */
  deepMerge(template, existing, path = '') {
    const merged = {};
    const fieldsAdded = [];

    // First, copy all template keys
    for (const key in template) {
      if (key === '//comment') continue; // Skip comment keys

      const templateValue = template[key];
      const existingValue = existing[key];
      const fieldPath = path ? `${path}.${key}` : key;

      if (!(key in existing)) {
        // Key missing from existing - add from template
        merged[key] = templateValue;
        fieldsAdded.push(fieldPath);
      } else if (typeof templateValue === 'object' && templateValue !== null && !Array.isArray(templateValue)) {
        // Template value is an object - existing should be too
        if (typeof existingValue === 'object' && existingValue !== null && !Array.isArray(existingValue)) {
          // Both are objects - recurse to merge nested fields
          const result = this.deepMerge(templateValue, existingValue, fieldPath);
          merged[key] = result.merged;
          fieldsAdded.push(...result.fieldsAdded);
        } else {
          // Type mismatch - template is object but existing is not
          // Fix corrupted data by using template value
          merged[key] = templateValue;
          fieldsAdded.push(fieldPath);
          logger.warn(
            { field: fieldPath, expectedType: 'object', actualType: typeof existingValue },
            'Config field has incorrect type, replacing with template value'
          );
        }
      } else {
        // Primitive or array - use existing value
        merged[key] = existingValue;
      }
    }

    // Copy any keys from existing that aren't in template (preserve extra user fields)
    for (const key in existing) {
      if (!(key in merged)) {
        merged[key] = existing[key];
      }
    }

    return { merged, fieldsAdded };
  }

  /**
   * Merge existing config with template to add missing fields