feat(network): add logRequest API for traffic that bypasses URLSession (gRPC, custom transports) - #442

Summary

Adds DebugSwift.Network.shared.logRequest(...) — a public API to log requests that bypass URLSession and are therefore invisible to the swizzler: gRPC over SwiftNIO (grpc-swift), custom sockets, or any hand-rolled transport. Logged entries appear in the Network tab alongside automatically captured traffic.

Today HttpModel and HttpDatasource are internal, so apps using gRPC have no way to surface those calls in DebugSwift. This is a universal entry point rather than a gRPC-specific integration: any transport can feed the Network tab through it.

Approach

The method builds an HttpModel and routes it through the existing pipeline, so behavior matches automatically captured traffic:

• ignoredURLs / onlyURLs filtering via HttpDatasource.addHttpRequest
• status-code descriptions via ErrorHelper
• UI refresh via the existing reloadHttp_DebugSwift notification (same as WKWebViewNetworkMonitor)
• returns Bool so callers know whether the entry was stored

No changes to existing behavior — purely additive.

Public API

// Example: logging a gRPC call from a grpc-swift client interceptor
DebugSwift.Network.shared.logRequest(
    url: URL(string: "grpc://api.example.com/example.v1.UserService/GetUser")!,
    method: "POST",
    requestHeaders: requestMetadata,
    requestBody: requestJSON.data(using: .utf8),
    responseStatusCode: status.isOk ? 200 : 500,
    responseHeaders: responseMetadata,
    responseBody: responseJSON.data(using: .utf8),
    error: transportError,
    startTime: callStartDate,
    endTime: Date()
)

Type of change

• Fix
• Feature
• Refactor
• Docs
• CI/CD

Test plan

• Unit tests updated
• Manual testing completed
• CI passing

Manual test steps

1. Call DebugSwift.Network.shared.logRequest(...) from a gRPC client interceptor (or any code path outside URLSession).
2. Open the Network tab — the entry appears in the list with method, status, size and duration, and opens into the standard request detail screen.
3. Add the host to ignoredURLs and repeat — the entry is filtered out and logRequest returns false.

Tests

NetworkCustomRequestLoggingTests (6 tests): field mapping, error → isSuccess == false, ignoredURLs/onlyURLs filtering, reload notification, zero-duration default.

Test Suite 'NetworkCustomRequestLoggingTests' passed
Executed 6 tests, with 0 failures (0 unexpected)
** TEST SUCCEEDED **

The package also builds in Swift 6 language mode.

Files Changed

• DebugSwift.Network.swift — new logRequest(...) public method
• NetworkCustomRequestLoggingTests.swift (new) — 6 tests
• README.md — "Custom Request Logging (gRPC and other non-URLSession transports)" section with a gRPC interceptor example

Checklist

• I reviewed my own changes
• I updated docs when needed
• I considered backward compatibility