perf(billing,settlement): paginate claims and wallet transactions (H9, H10)

GET /billing/claims loaded every tenant claim with no limit. Add
findByTenant(page, limit) + countByTenant (shared query builder), default
limit 50 / max 100, and expose totals as data.meta — kept inside the existing
{ data: { data: [...] } } envelope so current clients are unaffected.

GET /wallet/transactions was already bounded (findByUser defaulted to limit 50)
but page-less; add page/offset + countByUser + the same additive meta.

Regression: tests/Billing/ClaimsListPaginationTest,
tests/Settlement/WalletTransactionsPaginationTest.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/Billing/Controller/BillingController.php

@@ -184,9 +184,23 @@ class BillingController extends BaseController
             'to'           => $request->query->get('to') ?: null,
             'q'            => $request->query->get('q') ?: null,
         ];
-        $claims = $this->claimRepo->findByTenant($entityType, $entityId, $filters);
 
-        return $this->success(['data' => $this->enrichClaims($claims)]);
+        $page  = max(1, (int) $request->query->get('page', 1));
+        $limit = min(100, max(1, (int) $request->query->get('limit', 50)));
+
+        $claims = $this->claimRepo->findByTenant($entityType, $entityId, $filters, $page, $limit);
+        $total  = $this->claimRepo->countByTenant($entityType, $entityId, $filters);
+
+        // meta added inside the existing { data: { data: [...] } } envelope so
+        // existing clients keep reading data.data unchanged.
+        return $this->success([
+            'data' => $this->enrichClaims($claims),
+            'meta' => [
+                'totalRecords' => $total,
+                'totalPages'   => (int) ceil($total / $limit),
+                'currentPage'  => $page,
+            ],
+        ]);
     }
 
     #[Route('/api/v1/billing/claims/{uuid}/{action}', methods: ['POST'], requirements: ['action' => 'submit|approve|reject|pay'])]