Tap Proxy (TapProxy)

Infocyph\InterMix\Remix\TapProxy is the engine behind the zero‐argument tap() call. Whenever you write:

$someObject->tap()->foo()->bar()->baz();

this actually creates a TapProxy($someObject). Then each chained method (foo(), bar(), baz()) is invoked on the real target, but the proxy always returns the original target (not the proxy itself). That means your chain never breaks and you never have to assign the result manually.

Global Helper Function tap()

tap(mixed $value, ?callable $callback = null) → mixed

Usage Examples

// 1) With a callback: let me “observe” $user and still return $user.
$user = tap($user, fn($u) => logger()->info("User id={$u->id}"));

// 2) Proxy method chaining: call methods but keep $user at end.
tap($user)
    ->setName('Alice')
    ->activate()
    ->sendWelcomeEmail();