mmt/laravel-iam-service-sdk

Laravel SDK for interacting with the MMT IAM Service.

v1.0.0.0 2026-07-16 20:18 UTC

Requires

• php: ^8.3
• guzzlehttp/guzzle: ^7.2
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^10.0
• phpunit/phpunit: ^12.5

MIT

• sdk
• laravel
• iam
• MMT

Published on Packagist.org on 2026-07-16 20:21 UTC

README

Cliente Laravel (SDK) para el MMT IAM Service: perfiles de usuario, red IB, settings IB y 2FA, con transporte intercambiable, respuestas tipadas (ObjectResponses + WireHydration) y contratos documentados.

Espejo de mmt/laravel-trading-service-sdk (sin capa Session; IAM es stateless).

Requisitos

• PHP ^8.3
• Guzzle ^7.2
• Laravel ^11|^12|^13 (Illuminate Support)

Instalación

composer require mmt/laravel-iam-service-sdk
php artisan vendor:publish --tag=laravel-iam-service-sdk-config

Publicado en Packagist como mmt/laravel-iam-service-sdk. Repo: MMT-IAM-SERVICE-SDK.

Configuración

Variable	Descripción
RBAC_IAM_BASE_URL / USER_IAM_BASE_URL	URL base del IAM MS
RBAC_IAM_INTERNAL_TOKEN	Token interno (X-Internal-Token)
RBAC_INTERNAL_CALLER_SOURCE	Identificador del MS llamador (X-Internal-Source, default ms-broker)
USER_IAM_TIMEOUT_MS / RBAC_IAM_TIMEOUT_MS	Timeout HTTP en ms

Uso

use Mmt\IamServiceSdk\IamService;
use Mmt\IamServiceSdk\Domains\Users\ObjectResponses\UserProfileItem;

$iam = app(IamService::class);

$result = $iam->users()->getProfile($userId);

if ($result->isSuccess()) {
    /** @var UserProfileItem $profile */
    $profile = $result->getMappedData(UserProfileItem::class);
}

Dominios disponibles:

• $iam->referralNetwork() — upline, downline, direct referrals
• $iam->ibSettings() — getNetworkSettings()
• $iam->auth() — confirmTwoFactor($code, $extraHeaders)
• $iam->users() — getProfile($userId) (lookups fuera-de-request)
• $iam->health() — health check

Transporte intercambiable

use Mmt\IamServiceSdk\TransportDrivers\Contracts\TransportInterface;

$this->app->instance(TransportInterface::class, $fakeTransport);

ActionResultInterface expone getStatus(): ?int además de getData(?FQCN) y getMappedData(?FQCN) para soportar semántica IAM (422 USER_NOT_IB, 4xx vs 5xx en 2FA).

Arquitectura

broker Features → User Gateway (adaptadores + mappers) → IamService → TransportInterface → IAM MS

mmtech/iam-rbac sigue manejando auth/permisos/Kafka; este SDK cubre consumo de métodos de negocio IAM.

Licencia

MIT