feat(core): add http debug utility to core/protocols

[kuhe]

PR adds a function addHttpDebugLogMiddleware exported from @smithy/core/debug, a standalone submodule that will not affect the size of existing applications.

The configurable function attaches middleware to a client or command middleware stack and logs HTTP messages.
The level of detail can be configured, and XML and JSON formatting are supported.

import { DynamoDB } from "@aws-sdk/client-dynamodb";
import { addHttpDebugLogMiddleware } from "@smithy/core/debug";

const client = new DynamoDB();

// 2nd parameter is options. It can be an object or a string with word-matches.
// See PR diff for details.
addHttpDebugLogMiddleware(client.middlewareStack, "line headers formatted");

await client
  .describeTable({
    TableName: "test",
  })
  .catch(() => {});

output:

200 POST DynamoDBClient DescribeTableCommand
    https://....ddb.us-west-2.amazonaws.com/
    >> Request Headers: {
      "content-type": "application/x-amz-json-1.0",
      "x-amz-target": "DynamoDB_20120810.DescribeTable",
      "content-length": "...",
      "x-amz-user-agent": "aws-sdk-js/3.767.0",
      "user-agent": "aws-sdk-js/3.767.0 ua/2.1 os/darwin#24.3.0 lang/js md/nodejs#20.18.1 api/dynamodb#3.767.0 m/E,O,P,T,i,o",
      "host": ".....ddb.us-west-2.amazonaws.com",
      "amz-sdk-invocation-id": "a0aa9a03-72a6-4b6f-8587-....",
      "amz-sdk-request": "attempt=1; max=3",
      "x-amz-date": "20250318T201446Z",
      "x-amz-security-token": "***",
      "x-amz-content-sha256": "....",
      "authorization": "AWS4-HMAC-SHA256 Credential=***/20250318/us-west-2/dynamodb/aws4_request, SignedHeaders=amz-sdk-invocation-id;amz-sdk-request;content-length;content-type;host;x-amz-content-sha256;x-amz-date;x-amz-security-token;x-amz-target;x-amz-user-agent, Signature=***"
    }
    << Response Headers: {
      "server": "Server",
      "date": "Tue, 18 Mar 2025 20:14:46 GMT",
      "content-type": "application/x-amz-json-1.0",
      "content-length": "....",
      "connection": "keep-alive",
      "x-amzn-requestid": "....",
      "x-amz-crc32": "...."
    }
    ====== Response Body Start ======
    {
      "Table": {
        "AttributeDefinitions": [
          ...
        ],
        "BillingModeSummary": {
          ...
        },
        ... 
      }
    }
    ====== Response Body End ======