{"record":{"id":"ab33294b625dcd3f","repo":"googleapis/mcp-toolbox","slug":"invalid-map-value-format","errorCode":null,"errorMessage":"invalid map value format","messagePattern":"invalid map value format","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/tools/firestore/util/converter.go","lineNumber":137,"sourceCode":"\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn nil, fmt.Errorf(\"invalid array value format\")\n\t\t\t\tcase \"mapValue\":\n\t\t\t\t\t// Convert map\n\t\t\t\t\tif mapMap, ok := val.(map[string]any); ok {\n\t\t\t\t\t\tif fields, ok := mapMap[\"fields\"].(map[string]any); ok {\n\t\t\t\t\t\t\tresult := make(map[string]any)\n\t\t\t\t\t\t\tfor k, v := range fields {\n\t\t\t\t\t\t\t\tconverted, err := JSONToFirestoreValue(v, client)\n\t\t\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\t\t\treturn nil, fmt.Errorf(\"map field %q: %w\", k, err)\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tresult[k] = converted\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\treturn result, nil\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn nil, fmt.Errorf(\"invalid map value format\")\n\t\t\t\tcase \"referenceValue\":\n\t\t\t\t\t// Convert to DocumentRef if client is provided\n\t\t\t\t\tif strVal, ok := val.(string); ok {\n\t\t\t\t\t\tif client != nil && isValidDocumentPath(strVal) {\n\t\t\t\t\t\t\treturn client.Doc(strVal), nil\n\t\t\t\t\t\t}\n\t\t\t\t\t\t// Return the path as string if no client or invalid path\n\t\t\t\t\t\treturn strVal, nil\n\t\t\t\t\t}\n\t\t\t\t\treturn nil, fmt.Errorf(\"reference value must be a string\")\n\t\t\t\tdefault:\n\t\t\t\t\t// If not a typed value, treat as regular map\n\t\t\t\t\treturn convertPlainMap(v, client)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t// Regular map without type annotation\n\t\treturn convertPlainMap(v, client)","sourceCodeStart":119,"sourceCodeEnd":155,"githubUrl":"https://github.com/googleapis/mcp-toolbox/blob/8cc6e09de2ad7b8bffc77751799585a1401a48eb/internal/tools/firestore/util/converter.go#L119-L155","documentation":"Shape guard in JSONToFirestoreValue for mapValue: the value is not a map with a `fields` object (or is not a map at all), so its entries cannot be enumerated.","triggerScenarios":"Thrown at internal/tools/firestore/util/converter.go:137 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Send maps as {\"fields\": {\"key\": <value>, ...}}","Ensure the outer value is a JSON object with a fields member"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8cc6e09de2ad7b8bffc77751799585a1401a48eb","analyzedAt":"2026-09-05T01:10:36.887Z","contentChangedAt":"2026-09-05T01:10:36.887Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}