feat: Port Laravel's once() helper with coroutine safety

[binaryfire]

This PR ports Laravel's once() memoization helper to Hypervel, adapted for coroutine safety.

What's included

• Once class - Stores memoized values using Context instead of static properties, ensuring per-coroutine isolation
• Onceable class - Generates unique hashes from call traces to identify memoization targets
• once() helper - Same as Laravel's API: once(fn () => expensive())
• HasOnceHash contract - Allows objects to provide custom hash values for memoization

Coroutine safety

Laravel's implementation uses a static WeakMap which would leak state between concurrent requests in Swoole. This implementation stores the WeakMap in Context, so each coroutine gets its own isolated memoization cache.

// Each coroutine gets independent memoization
$result = once(fn () => $this->expensiveCalculation());

Tests

• OnceTest - Verifies caching behavior and coroutine isolation
• OnceableTest - Verifies trace-based hash generation and HasOnceHash support

[Copilot]

Pull request overview

This PR ports Laravel's once() memoization helper to Hypervel, adapted for coroutine safety by using Context instead of static properties for storage isolation.

Changes:

• Adds the once() helper function that caches callable results based on call location and context
• Implements coroutine-safe memoization using Hypervel's Context system instead of static properties
• Includes comprehensive tests for caching behavior, coroutine isolation, and hash generation

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/support/src/Once.php	Main memoization class storing cached values in WeakMap within Context for coroutine isolation
src/support/src/Onceable.php	Generates unique hashes from call traces and closure variables to identify memoization targets
src/support/src/Contracts/HasOnceHash.php	Interface allowing objects to provide custom hash values for memoization
src/support/src/helpers.php	Adds the once() helper function with Laravel-compatible API
tests/Support/OnceTest.php	Tests caching behavior, closure differentiation, and coroutine-scoped isolation
tests/Support/OnceableTest.php	Tests trace-based object capture and HasOnceHash implementation
src/horizon/src/ProcessInspector.php	Removes redundant PHPDoc type annotation
src/console/src/Scheduling/ManagesFrequencies.php	Fixes incorrect duplicate type in docblock parameter

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.