Mini API: account settings, wallet & support endpoints for the app.

Adds /api/v1/mini account (settings, profile, change-password), wallet (balance + ledger, Paystack top-up) and support (Afia chat) endpoints. Account/profile/ password/top-up proxy to the central identity API via a CallsIdentityApi trait; notifications, wallet balance and support chat are served locally. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-11 11:03:33 +00:00
parent 90d7aab547
commit c39e38cbe0
5 changed files with 285 additions and 0 deletions
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Controllers\Api\Concerns;
+
+use Illuminate\Http\Client\ConnectionException;
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Http\Client\Response as HttpResponse;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Validation\ValidationException;
+
+/**
+ * Shared helper for talking to the central Ladill identity API
+ * (auth.ladill.com /api/identity/*) with the first-party service key.
+ */
+trait CallsIdentityApi
+{
+    protected function identity(): PendingRequest
+    {
+        return Http::baseUrl(rtrim((string) config('services.ladill_identity.url'), '/'))
+            ->withToken((string) config('services.ladill_identity.key'))
+            ->connectTimeout(10)
+            ->timeout(20)
+            ->acceptJson()
+            ->asJson();
+    }
+
+    protected function identitySend(string $method, string $path, array $payload): HttpResponse
+    {
+        try {
+            return $this->identity()->send($method, $path, ['json' => $payload]);
+        } catch (ConnectionException) {
+            throw ValidationException::withMessages([
+                'base' => ['Could not reach Ladill. Please try again in a moment.'],
+            ]);
+        }
+    }
+
+    /** Re-throw a 422 from the identity API as local validation errors. */
+    protected function rethrowValidation(HttpResponse $response, string $fallbackField = 'base'): void
+    {
+        if ($response->status() === 422) {
+            throw ValidationException::withMessages(
+                $response->json('errors') ?: [$fallbackField => [$response->json('message') ?: 'Request failed.']],
+            );
+        }
+    }
+}
@@ -0,0 +1,111 @@
+<?php
+
+namespace App\Http\Controllers\Api\Mini;
+
+use App\Http\Controllers\Api\Concerns\CallsIdentityApi;
+use App\Http\Controllers\Controller;
+use App\Models\QrSetting;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AccountController extends Controller
+{
+    use CallsIdentityApi;
+
+    public function settings(): JsonResponse
+    {
+        $account = ladill_account();
+        $settings = $account->getOrCreateQrSetting();
+
+        return response()->json([
+            'data' => [
+                'profile' => [
+                    'name' => $account->name,
+                    'email' => $account->email,
+                ],
+                'notifications' => [
+                    'notify_email' => $settings->notify_email ?: $account->email,
+                    'product_updates' => (bool) ($settings->product_updates ?? true),
+                    'notify_registrations' => (bool) ($settings->notify_registrations ?? true),
+                    'notify_payouts' => (bool) ($settings->notify_payouts ?? true),
+                ],
+            ],
+        ]);
+    }
+
+    public function updateSettings(Request $request): JsonResponse
+    {
+        $account = ladill_account();
+
+        $data = $request->validate([
+            'notify_email' => ['nullable', 'email', 'max:255'],
+            'product_updates' => ['sometimes', 'boolean'],
+            'notify_registrations' => ['sometimes', 'boolean'],
+            'notify_payouts' => ['sometimes', 'boolean'],
+        ]);
+
+        $settings = QrSetting::updateOrCreate(
+            ['user_id' => $account->id],
+            [
+                'notify_email' => $data['notify_email'] ?? $account->email,
+                'product_updates' => $request->boolean('product_updates'),
+                'notify_registrations' => $request->boolean('notify_registrations'),
+                'notify_payouts' => $request->boolean('notify_payouts'),
+            ],
+        );
+
+        return response()->json([
+            'data' => [
+                'notify_email' => $settings->notify_email,
+                'product_updates' => (bool) $settings->product_updates,
+                'notify_registrations' => (bool) $settings->notify_registrations,
+                'notify_payouts' => (bool) $settings->notify_payouts,
+            ],
+        ]);
+    }
+
+    public function updateProfile(Request $request): JsonResponse
+    {
+        $account = ladill_account();
+
+        $data = $request->validate([
+            'name' => ['required', 'string', 'max:255'],
+            'phone_cc' => ['nullable', 'string', 'max:8'],
+            'phone' => ['nullable', 'string', 'max:32'],
+        ]);
+
+        $response = $this->identitySend('PUT', '/api/identity/profile', array_merge(
+            ['user' => $account->public_id],
+            $data,
+        ));
+        $this->rethrowValidation($response, 'name');
+
+        if ($response->successful()) {
+            $account->update(['name' => $data['name']]);
+        }
+
+        return response()->json([
+            'data' => ['name' => $account->fresh()->name, 'email' => $account->email],
+        ]);
+    }
+
+    public function changePassword(Request $request): JsonResponse
+    {
+        $account = ladill_account();
+
+        $request->validate([
+            'current_password' => ['required', 'string'],
+            'password' => ['required', 'string', 'min:8', 'confirmed'],
+        ]);
+
+        $response = $this->identitySend('POST', '/api/identity/auth/change-password', [
+            'user' => $account->public_id,
+            'current_password' => $request->string('current_password'),
+            'password' => $request->string('password'),
+            'password_confirmation' => $request->string('password_confirmation'),
+        ]);
+        $this->rethrowValidation($response, 'current_password');
+
+        return response()->json(['data' => ['message' => 'Password updated.']]);
+    }
+}
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Controllers\Api\Mini;
+
+use App\Http\Controllers\Controller;
+use App\Services\Afia\AfiaService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class SupportController extends Controller
+{
+    public function chat(Request $request, AfiaService $afia): JsonResponse
+    {
+        $validated = $request->validate([
+            'message' => ['required', 'string', 'max:2000'],
+            'history' => ['nullable', 'array', 'max:20'],
+            'history.*.role' => ['nullable', 'string'],
+            'history.*.text' => ['nullable', 'string'],
+        ]);
+
+        if (! $afia->enabled()) {
+            return response()->json(['message' => 'Support chat is not available right now.'], 503);
+        }
+
+        try {
+            $reply = $afia->chat(trim($validated['message']), $validated['history'] ?? [], $this->context());
+        } catch (\Throwable $e) {
+            report($e);
+
+            return response()->json(['message' => 'We could not respond right now. Please try again.'], 502);
+        }
+
+        return response()->json(['data' => ['reply' => $reply]]);
+    }
+
+    /** @return array<string, mixed> */
+    private function context(): array
+    {
+        $account = ladill_account();
+
+        return [
+            'app' => 'Ladill Mini',
+            'description' => 'Ladill Mini is a payments app: merchants create payment QR codes and links, collect payments, and track takings and payouts.',
+            'account_name' => $account?->name,
+        ];
+    }
+}
@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Http\Controllers\Api\Mini;
+
+use App\Http\Controllers\Api\Concerns\CallsIdentityApi;
+use App\Http\Controllers\Controller;
+use App\Services\Billing\BillingClient;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+use Throwable;
+
+class WalletController extends Controller
+{
+    use CallsIdentityApi;
+
+    public function __construct(private BillingClient $billing) {}
+
+    public function show(): JsonResponse
+    {
+        $account = ladill_account();
+        $balanceMinor = 0;
+        $ledger = [];
+
+        try {
+            $balanceMinor = $this->billing->balanceMinor($account->public_id);
+            $ledger = $this->billing->serviceLedger($account->public_id, config('billing.service', 'mini'));
+        } catch (Throwable $e) {
+            Log::warning('Mini API wallet load failed', ['user' => $account->public_id, 'error' => $e->getMessage()]);
+        }
+
+        return response()->json([
+            'data' => [
+                'currency' => 'GHS',
+                'balance_minor' => $balanceMinor,
+                'spent_minor' => (int) ($ledger['spent_minor'] ?? 0),
+                'credited_minor' => (int) ($ledger['credited_minor'] ?? 0),
+            ],
+        ]);
+    }
+
+    public function topup(Request $request): JsonResponse
+    {
+        $account = ladill_account();
+
+        $data = $request->validate([
+            'amount' => ['required', 'numeric', 'min:1', 'max:10000'],
+        ]);
+
+        $response = $this->identitySend('POST', '/api/identity/wallet-topup-account', [
+            'user' => $account->public_id,
+            'amount' => (float) $data['amount'],
+            // Paystack returns the customer here after payment; the app catches the deep link.
+            'return_url' => 'https://'.config('app.platform_domain').'/mini/wallet/topup-complete',
+        ]);
+        $this->rethrowValidation($response, 'amount');
+
+        $checkoutUrl = (string) $response->json('data.checkout_url', '');
+        if ($checkoutUrl === '') {
+            return response()->json(['message' => 'Could not start top-up. Please try again.'], 422);
+        }
+
+        return response()->json(['data' => ['checkout_url' => $checkoutUrl]]);
+    }
+}