#MongoDB 驱动版本兼容性指南

const result = await collection.findOneAndUpdate(filter, update);
// result 格式：
{
  value: { _id: ..., name: "Alice" },  // 文档
  ok: 1,                                // 操作状态
  lastErrorObject: {                    // 错误信息
    n: 1,
    updatedExisting: true
  }
}

const result = await collection.findOneAndUpdate(filter, update);
// result 格式：
{
  value: { _id: ..., name: "Alice" }  // 只返回文档
}

// 使用 monSQLize，所有 Driver 版本返回格式统一
const user = await collection.findOneAndUpdate(
  { name: 'Alice' },
  { $set: { age: 31 } }
);

// ✅ 所有版本都返回统一格式：文档本身
console.log(user);  // { _id: ..., name: "Alice", age: 31 }

// 不需要判断版本：
// ❌ 不需要: if (result.value) return result.value;
// ❌ 不需要: if (result.ok) return result;

// monSQLize 内部自动处理
adaptFindOneAndUpdateResult(result) {
  if (!result) return null;
  
  // Driver 5.x/6.x: 直接返回 value
  if (result.value !== undefined && !result.ok) {
    return result.value;
  }
  
  // Driver 4.x: 提取 value
  if (result.ok && result.value !== undefined) {
    return result.value;
  }
  
  return result;
}

// 1. 处理返回值格式差异
handleFindOneAndResult(result, options, logger)

// 2. 安全判断文档是否被修改
wasDocumentModified(result)

// 3. 检测驱动版本
detectDriverVersion()

// 4. 输出版本警告
warnUnsupportedDriverVersion(logger)

// 驱动版本 < 6.x
logger.warn("[result-handler] ⚠️ 检测到 MongoDB 驱动版本过旧", {
  detectedVersion: 5,
  supportedVersion: "6.x",
  message: "monSQLize 专为 MongoDB 驱动 6.x 设计，旧版本可能存在兼容性问题",
  recommendation: "建议升级到 MongoDB Node.js 驱动 ^6.0.0"
});

// 驱动版本 > 6.x
logger.warn("[result-handler] ⚠️ 检测到 MongoDB 驱动版本未经测试", {
  detectedVersion: 7,
  testedVersion: "6.x",
  message: "monSQLize 已针对 MongoDB 驱动 6.x 测试，新版本可能存在未知问题",
  recommendation: "如遇问题，请查看技术分析报告或回退到驱动 6.x"
});

// 驱动在某些边界情况可能返回 null
handleFindOneAndResult(null, {});
// 返回: null（用户视角正常）

// 日志输出
logger.debug("[result-handler] Result is null/undefined, returning empty result");

// 驱动返回了非预期格式
const result = { _id: 1, name: "Alice" }; // 缺少 value 和 lastErrorObject
handleFindOneAndResult(result, {});

// 自动补充缺失字段
// 日志输出
logger.warn("[result-handler] ⚠️ Result missing lastErrorObject, possible driver version issue", {
  hasValue: false,
  resultKeys: ["_id", "name"],
  driverVersion: 6,
  recommendation: "这可能表明 MongoDB 驱动返回了非预期的格式，请检查驱动版本"
});

// lib/mongodb/writes/result-handler.js

function handleFindOneAndResult(result, options = {}, logger = null) {
    const driverVersion = detectDriverVersion();
    
    // 驱动 7.x 的新格式
    if (driverVersion >= 7) {
        // 适配新格式
        if (result && result.document !== undefined) {
            // 转换为统一格式
            result = {
                value: result.document,
                ok: 1,
                lastErrorObject: result.metadata || { n: result.document ? 1 : 0 }
            };
        }
    }
    
    // 驱动 6.x 的处理逻辑（保持不变）
    // ...existing code...
    
    // 统一返回
    if (options.includeResultMetadata) {
        return result;
    } else {
        return result.value !== undefined ? result.value : null;
    }
}

// lib/mongodb/writes/custom-find-one-and-modify.js

const { handleFindOneAndResult, wasDocumentModified } = require("./result-handler");

async function customFindOneAndModify(filter, modification, options = {}) {
    const { logger } = this.context;
    
    try {
        // 1. 强制获取完整元数据
        const driverOptions = { ...options, includeResultMetadata: true };
        
        // 2. 调用 MongoDB 驱动
        const result = await nativeCollection.customMethod(filter, modification, driverOptions);
        
        // 3. 判断是否需要失效缓存
        const wasModified = wasDocumentModified(result);
        if (cache && wasModified) {
            // 缓存失效逻辑
        }
        
        // 4. 使用统一的返回值处理（传递 logger）
        return handleFindOneAndResult(result, options, logger);
        
    } catch (error) {
        // 错误处理
    }
}

const mongodb = require("mongodb");
console.log("MongoDB Driver Version:", mongodb.version);