[ENG-3815] feat(microsoft): BatchRecordReader

[Cobalt0s]

Description

Adds testroutines.ReadByIds, enabling reusable unit tests for any BatchRecordReaderConnector implementation.

Also introduces a Microsoft implementation of GetRecordsByIds, built on top of the batch strategy for the Microsoft Graph Batch API.

Testing

• Live test creates 3 Outlook messages
• Reads them in batch by ID
• Cleans up the created records afterward

Live Tests

Script output is copied. Some object fields are truncated.

[SETUP] Creating a record for object 'me/messages'
Reading me/messages
Finding recently created me/messages
Object me/messages(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j8AAA=) is ready
[SETUP] Creating a record for object 'me/messages'
Reading me/messages
Finding recently created me/messages
Object me/messages(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j9AAA=) is ready
[SETUP] Creating a record for object 'me/messages'
Reading me/messages
Finding recently created me/messages
Object me/messages(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j_AAA=) is ready
========================

[
  {
    "Associations": {},
    "Fields": {
      "body": {
        "content": "Zoe Stamm",
        "contentType": "text"
      },
      "from": {
        "emailAddress": {
          "address": "Reilly5008@test.com",
          "name": "Reilly5008"
        }
      },
      "subject": "Nelson Dickens [1]",
      "torecipients": [
        {
          "emailAddress": {
            "address": "Rutherford6844@test.com",
            "name": "Rutherford6844"
          }
        }
      ]
    },
    "Id": "AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j8AAA=",
    "Raw": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('ae87552f-48fc-4dec-9322-65040bf9fdfd')/messages/$entity",
      "@odata.etag": "W/\"CQAAABYAAAB8hj1Rtd60SKTngNs3if9RAAEuxchC\"",
      "bccRecipients": [],
      "body": {
        "content": "Zoe Stamm",
        "contentType": "text"
      },
      "bodyPreview": "Zoe Stamm"
    }
  },
  {
    "Associations": {},
    "Fields": {
      "body": {
        "content": "Meta Hilpert",
        "contentType": "text"
      },
      "from": {
        "emailAddress": {
          "address": "Jacobs9280@test.com",
          "name": "Jacobs9280"
        }
      },
      "subject": "Branson Lakin [2]",
      "torecipients": [
        {
          "emailAddress": {
            "address": "Luettgen3944@test.com",
            "name": "Luettgen3944"
          }
        }
      ]
    },
    "Id": "AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j9AAA=",
    "Raw": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('ae87552f-48fc-4dec-9322-65040bf9fdfd')/messages/$entity",
      "@odata.etag": "W/\"CQAAABYAAAB8hj1Rtd60SKTngNs3if9RAAEuxchE\"",
      "bccRecipients": [],
      "body": {
        "content": "Meta Hilpert",
        "contentType": "text"
      },
      "bodyPreview": "Meta Hilpert"
    }
  },
  {
    "Associations": {},
    "Fields": {
      "body": {
        "content": "Claudia Powlowski",
        "contentType": "text"
      },
      "from": {
        "emailAddress": {
          "address": "Cartwright9168@test.com",
          "name": "Cartwright9168"
        }
      },
      "subject": "Jakayla Ruecker [3]",
      "torecipients": [
        {
          "emailAddress": {
            "address": "Reinger6985@test.com",
            "name": "Reinger6985"
          }
        }
      ]
    },
    "Id": "AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j_AAA=",
    "Raw": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('ae87552f-48fc-4dec-9322-65040bf9fdfd')/messages/$entity",
      "@odata.etag": "W/\"CQAAABYAAAB8hj1Rtd60SKTngNs3if9RAAEuxchG\"",
      "bccRecipients": [],
      "body": {
        "content": "Claudia Powlowski",
        "contentType": "text"
      },
      "bodyPreview": "Claudia Powlowski"
    }
  }
]

========================
[CLEANUP] Successful removal
	Object(me/messages)
	ID(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j_AAA=)
[CLEANUP] Successful removal
	Object(me/messages)
	ID(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j9AAA=)
[CLEANUP] Successful removal
	Object(me/messages)
	ID(AAMkAGY0YzAwY2ViLWQyODktNDI3NS1iNmY4LTE5YzU0MjI5ZTA4OQBGAAAAAABeMJSlO8qLToz2i2IQ1wsqBwB8hj1Rtd60SKTngNs3if9RAACsvo1TAAB8hj1Rtd60SKTngNs3if9RAAEuy3j8AAA=)

[linear]

ENG-3815 Microsoft subscribe actions

[Cobalt0s]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• [ENG-3815] feat(microsoft): Impl Subscription Maintainer #2946
• [ENG-3815] feat(microsoft): Impl Update Subscription #2879
• [ENG-3815] feat(microsoft): Impl Delete Subscription #2880
• [ENG-3815] feat(microsoft): Impl Create Subscription #2878
• feat(subscriptions): Scripts for consuming events #2948
• [ENG-3815] feat(microsoft): WebhookVerifier #2877
• [ENG-3815] feat(microsoft): Webhook Message format #2875
• [ENG-3815] feat(microsoft): BatchRecordReader #2874 👈 (View in Graphite)
• feat(microsoft): Batch API #2945
• feat(components): Subscription interfaces #2876
• feat(codec): Dual marshal preserve RawJSON #2276 : 1 other dependent PR (#2277 )
• tidy(testutils): Relocate CompareResult #2944
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.