Foundation slice for Mantis #844 php/Mod/Api RFC implementation: * New php/Mod/Api/ package: Boot, Controllers, Documentation, Jobs, Middleware, Models, RateLimit, Routes, Services * Models: ApiKey, WebhookEndpoint, WebhookDelivery * WebhookService::dispatch() with DB::transaction + afterCommit * DeliverWebhookJob with retry/backoff * WebhookSignature with timing-safe verification + 5-minute tolerance + dual-secret rotation support * Sliding-window rate limiter in RateLimit/RateLimitService.php * AuthenticateApiKey middleware: hk_ prefix + Sanctum fallback * DocsController / DocumentationController split * 3 root migrations: api_keys, webhook_endpoints, webhook_deliveries * Foundation tests under php/tests/Feature/Mod/Api/ * FOLLOWUP.md tracks remaining RFC scope php -l clean across 21 PHP files. Pest unrunnable in sandbox (no vendor/). Co-authored-by: Codex <noreply@openai.com> Closes tasks.lthn.sh/view.php?id=844
39 lines
769 B
PHP
39 lines
769 B
PHP
<?php
|
|
|
|
// SPDX-License-Identifier: EUPL-1.2
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Mod\Agentic\Mod\Api\RateLimit;
|
|
|
|
use Attribute;
|
|
|
|
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
|
|
readonly class RateLimit
|
|
{
|
|
public string $key;
|
|
|
|
public int $limit;
|
|
|
|
public int $window;
|
|
|
|
public float $burst;
|
|
|
|
public function __construct(
|
|
string|int $key = '',
|
|
?int $limit = null,
|
|
int $window = 60,
|
|
float $burst = 1.0,
|
|
) {
|
|
if (is_int($key) && $limit === null) {
|
|
$this->key = '';
|
|
$this->limit = $key;
|
|
} else {
|
|
$this->key = (string) $key;
|
|
$this->limit = $limit ?? 60;
|
|
}
|
|
|
|
$this->window = $window;
|
|
$this->burst = $burst;
|
|
}
|
|
}
|