dantofema/mogotes-laravel

This is my package mogotes-laravel

v1.0.0 2026-01-13 18:11 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^11.0||^12.0
• laravel/pennant: ^1.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• laravel/sail: ^1.52
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• rector/rector: ^2.1
• rector/rector-laravel: ^2.1
• spatie/laravel-ray: ^1.35

MIT

• alejandro-leone

• laravel
• dantofema
• mogotes-laravel

README

Cliente Laravel para interactuar con los servicios de Mogotes - Feature Flags, Notificaciones y Logs.

Instalación

composer require dantofema/mogotes-laravel

Publica el archivo de configuración:

php artisan vendor:publish --tag="mogotes-laravel-config"

Configura las variables de entorno en tu .env:

MOGOTES_API_KEY=tu_api_key_aqui
MOGOTES_SERVER_URL=https://api.mogotes.com
MOGOTES_WEBHOOK_SECRET=tu_webhook_secret

Uso

📧 Notificaciones

Envía notificaciones por email o WhatsApp usando plantillas configuradas en Mogotes.

use Dantofema\MogotesLaravel\Facades\Mogotes;

// Email
Mogotes::email(
    template: 'welcome-email',
    to: '[e-mail]',
    data: ['name' => 'Juan', 'code' => '12345']
);

// WhatsApp
Mogotes::whatsapp(
    template: 'order-confirmation',
    to: '[phone]',
    data: ['order_id' => '12345', 'total' => '$100']
);

// Notificación genérica (cualquier canal)
Mogotes::notifications()->send(
    channel: 'email',
    template: 'custom-template',
    to: '[e-mail]',
    data: ['key' => 'value'],
    idempotencyKey: 'unique-key-123' // Opcional
);

📊 Logs

Envía logs estructurados a Mogotes para centralizar el monitoreo de tu aplicación.

use Dantofema\MogotesLaravel\Facades\Mogotes;

// Log de información
Mogotes::log()->info('Usuario creado', [
    'user_id' => 123,
    'email' => '[e-mail]'
]);

// Log de error
Mogotes::log()->error('Falló el pago', [
    'payment_id' => 456,
    'error' => 'Tarjeta rechazada'
]);

// Otros niveles disponibles
Mogotes::log()->warning('Advertencia', ['context' => 'value']);
Mogotes::log()->debug('Debug info', ['data' => [...]]);

// Listar logs con filtros
$logs = Mogotes::log()->list([
    'level' => 'error',
    'from_date' => '2024-01-01',
    'to_date' => '2024-01-31',
    'per_page' => 50
]);

🚩 Feature Flags

Controla funcionalidades de tu aplicación de forma dinámica sin redesplegar código.

use Dantofema\MogotesLaravel\Facades\Mogotes;

// Verificar si un flag está activo
if (Mogotes::feature()->IsActive('nueva-funcionalidad')) {
    // Código para la nueva funcionalidad
}

// Con scope (por usuario, tenant, etc.)
if (Mogotes::feature()->IsActive('beta-feature', scopeId: 'user-123')) {
    // Funcionalidad beta para usuario específico
}

Integración con Laravel Pennant:

El paquete también registra automáticamente un driver de Pennant para usar Feature Flags nativamente:

use Laravel\Pennant\Feature;

// Verificar flag
if (Feature::active('nueva-funcionalidad')) {
    // ...
}

// Con scope
Feature::for($user)->active('beta-feature');

🔐 Webhooks

Recibe eventos de Mogotes en tu aplicación de forma segura.

Configuración automática

El paquete registra automáticamente la ruta /mogotes/webhook (configurable en .env):

MOGOTES_WEBHOOK_PATH=/mogotes/webhook
MOGOTES_WEBHOOK_REGISTER_ROUTE=true

Validación de firma

use Dantofema\MogotesLaravel\Services\WebhookSignatureValidator;

$validator = new WebhookSignatureValidator(
    secret: config('mogotes-laravel.webhooks.secret')
);

try {
    $validator->validate(
        rawBody: $request->getContent(),
        signature: $request->header('Mogotes-Signature'),
        timestamp: (int) $request->header('Mogotes-Timestamp')
    );
    
    // Webhook válido, procesar evento
    $event = $request->json();
    
} catch (InvalidWebhookSignatureException $e) {
    // Firma inválida o timestamp expirado
    return response()->json(['error' => 'Invalid signature'], 401);
}

Escuchar eventos

Crea listeners para los eventos de Mogotes:

use Dantofema\MogotesLaravel\Events\WebhookReceived;

Event::listen(WebhookReceived::class, function (WebhookReceived $event) {
    $payload = $event->payload;
    
    // Procesar evento según tipo
    match ($payload['event_type'] ?? null) {
        'notification.sent' => // Notificación enviada
        'notification.failed' => // Notificación fallida
        default => // Otro evento
    };
});

Configuración avanzada

// config/mogotes-laravel.php

return [
    'base_url' => env('MOGOTES_SERVER_URL', 'https://api.mogotes.com'),
    'api_key' => env('MOGOTES_API_KEY'),
    'timeout_seconds' => env('MOGOTES_TIMEOUT_SECONDS', 5),
    
    'feature_flags' => [
        'ttl_seconds' => env('MOGOTES_FEATURE_FLAGS_TTL_SECONDS', 300),
        'cache_enabled' => env('MOGOTES_FEATURE_FLAGS_CACHE_ENABLED', true),
    ],
    
    'webhooks' => [
        'register_route' => env('MOGOTES_WEBHOOK_REGISTER_ROUTE', true),
        'path' => env('MOGOTES_WEBHOOK_PATH', '/mogotes/webhook'),
        'secret' => env('MOGOTES_WEBHOOK_SECRET'),
    ],
];

Excepciones

El paquete lanza excepciones específicas para facilitar el manejo de errores:

• MogotesUnauthorizedException - API key inválida o expirada
• MogotesApiException - Error genérico de la API
• MogotesConnectionException - No se pudo conectar al servidor
• MogotesRateLimitException - Límite de requests excedido
• MogotesIdempotencyConflictException - Conflicto de idempotencia
• InvalidWebhookSignatureException - Firma de webhook inválida

Testing

composer test

License

The MIT License (MIT). Ver License File para más información.