lthn.io/app/Core/Bouncer/Gate/RouteActionMacro.php
Claude 41a90cbff8
feat: lthn.io API serving live chain data
Fixed: basePath self→static binding, namespace detection, event wiring,
SQLite cache, file cache driver. All Mod Boot classes converted to
$listens pattern for lifecycle event discovery.

Working endpoints:
- /v1/explorer/info — live chain height, difficulty, aliases
- /v1/explorer/stats — formatted chain statistics
- /v1/names/directory — alias directory grouped by type
- /v1/names/available/{name} — name availability check
- /v1/names/lookup/{name} — name details

Co-Authored-By: Charon <charon@lethean.io>
2026-04-03 17:17:42 +01:00

86 lines
2.2 KiB
PHP

<?php
/*
* Core PHP Framework
*
* Licensed under the European Union Public Licence (EUPL) v1.2.
* See LICENSE file for details.
*/
declare(strict_types=1);
namespace Core\Bouncer\Gate;
use Illuminate\Routing\Route;
/**
* Route macros for action gate integration.
*
* Provides fluent methods for setting action names on routes:
*
* ```php
* Route::post('/products', [ProductController::class, 'store'])
* ->action('product.create');
*
* Route::delete('/products/{product}', [ProductController::class, 'destroy'])
* ->action('product.delete', scope: 'product');
*
* Route::get('/public-page', PageController::class)
* ->bypassGate(); // Skip action gate entirely
* ```
*/
class RouteActionMacro
{
/**
* Register route macros for action gate.
*/
public static function register(): void
{
/**
* Set the action name for bouncer gate checking.
*
* @param string $action The action identifier (e.g., 'product.create')
* @param string|null $scope Optional resource scope
* @return Route
*/
Route::macro('action', function (string $action, ?string $scope = null): Route {
/** @var Route $this */
$this->setAction(array_merge($this->getAction(), [
'bouncer_action' => $action,
'bouncer_scope' => $scope,
]));
return $this;
});
/**
* Bypass the action gate for this route.
*
* Use sparingly for routes that should never be gated (e.g., login page).
*
* @return Route
*/
Route::macro('bypassGate', function (): Route {
/** @var Route $this */
$this->setAction(array_merge($this->getAction(), [
'bypass_gate' => true,
]));
return $this;
});
/**
* Mark this route as requiring training (explicit pending state).
*
* @return Route
*/
Route::macro('requiresTraining', function (): Route {
/** @var Route $this */
$this->setAction(array_merge($this->getAction(), [
'requires_training' => true,
]));
return $this;
});
}
}