Repost.Client.Testing 1.0.8

Repost.Client.Testing

Test doubles for the Repost.Client webhook publish client. Consumer tests drive the real runtime end to end — options validation, serialization, retry, and delivery semantics — without network access.

• StubTransport — a thread-safe scripted ITransport: an ordered FIFO script of one-attempt outcomes plus credential-free request recording (Authorization stripped, exact body copy). An empty script surfaces a faulted InvalidOperationException, the raw-defect shape the runtime never retries.
• ControlledResponse — the test-driven pending response from StubTransport.EnqueuePending(): Complete(...) / Fail(...) / Cancel(...) / IsDone.
• TestDefaultValueGenerators — Fixed(now, uuid, cuid), Sequence(...), Failing(...) injectables behind @default(now()/uuid()/cuid()) and the envelope timestamp.
• TestIdempotencyKeyGenerator — Fixed(key), Sequence(...), Failing(...) for RepostClientOptions.IdempotencyKeyGenerator.
• DeterministicRetryEntropy — Sequence(...) (range-validated, throws when exhausted) and Zero for RepostClientOptions.RetryEntropy.
• ManualTimeProvider — a TimeProvider whose wall and monotonic clocks share one counter advanced explicitly via Advance(...) / UtcNow, firing due timers in order.
• RecordingObserver — an IRepostObserver recorder with an Events snapshot and AwaitNextAsync(timeout).

Example

using Repost.Client;
using Repost.Client.Testing;

var transport = new StubTransport();
transport.EnqueueResponse(
    202,
    "{\"id\":\"msg_1\",\"type\":\"book.created\",\"customerId\":\"cus_1\","
        + "\"timestamp\":\"1970-01-01T00:00:00.000Z\"}");

var options = new RepostClientOptions
{
    ApiKey = "test-key",
    Transport = transport,
    DefaultValueGenerators = TestDefaultValueGenerators.Fixed(
        DateTimeOffset.UnixEpoch,
        "00000000-0000-4000-8000-000000000000",
        "ck0nf0rm4nc3f1x3dcu1d000"),
    IdempotencyKeyGenerator = TestIdempotencyKeyGenerator.Fixed("test-key-1"),
    RetryEntropy = DeterministicRetryEntropy.Zero,
};

The accepted-response body must echo the request envelope's type, customerId, and timestamp; fixing Now() makes that echo knowable, so the script above parses as a real acceptance.

Every recorded request is an assertion target:

RecordedRequest sent = transport.Requests[0];
// sent.RequestUri, sent.Headers (no Authorization), sent.Body,
// sent.ConnectTimeout, sent.AttemptTimeout, sent.CaptureSequence

There is intentionally no "no network" guard type: the runtime reaches the network only through RepostClientOptions.Transport, so injecting StubTransport makes a test network-free by construction.