feat(codec): JSON Record decorator

[Cobalt0s]

Description

This utility simplifies constructing payloads from records in Go, especially for Salesforce API integration.

In Go, anonymous struct embedding works perfectly for structs: embedded fields are injected at the same level, so you can compose a final JSON body from multiple structs and every field is "inherited" naturally on the same JSON node level.

However, this approach doesn’t work for non-struct properties. common.Record is a map[string]any, so a special decorator is required to merge additional properties.

For Salesforce, the difference between the client-supplied record and the payload is that we must:

1. Add the type of record (Salesforce object name).
2. Create a unique reference ID for bookkeeping, which is enforced by the API.

This utility makes it easy to create a Salesforce-ready model (NOTE: there is some existing code in some connector that also does side-car property emebeding which would benefit from it). During JSON marshaling, properties from Extension are automatically merged into Record.

Input:

[
  {
    "FirstName": "Siena",
    "LastName": "Dyer"
  },
  {
    "FirstName": "Markus",
    "LastName": "Blevins"
  }
]

Output:

{
  "records": [
    {
      "FirstName": "Siena",
      "LastName": "Dyer",
      "attributes": {
        "referenceId": "ref0",
        "type": "Contact"
      }
    },
    {
      "FirstName": "Markus",
      "LastName": "Blevins",
      "attributes": {
        "referenceId": "ref1",
        "type": "Contact"
      }
    }
  ]
}

[Cobalt0s]

• feat(codec): JSON Record decorator #2248 : 2 dependent PRs (#2233 , #2259 ) 👈 (View in Graphite)
• feat(common): Client with conditional err handling #2247
• feat(common): BatchWrite helper methods #2246
• feat(datautils): Map deep copy + For Each #2245
• feat(common): Create BatchWriteResult #2244
• [ENG-2914] feat(salesforce): New Batch Adapter #2232
• [ENG-2914] feat(interface): BatchWriteConnector #2231
• main

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