@adonis-agora/authkit-server 0.65.3 → 0.66.0

package/build/index.d.ts

@@ -109,6 +109,8 @@ export type { ProviderIdentityClass, ProviderIdentityRow, } from './src/mixins/w
 export { withProviderIdentity } from './src/mixins/with_provider_identity.js';
 export type { WebauthnCredentialClass, WebauthnCredentialRow, } from './src/mixins/with_webauthn_credential.js';
 export { withWebauthnCredential } from './src/mixins/with_webauthn_credential.js';
+export type { ListMeta, PaginatedResponse } from './src/pagination.js';
+export { ADMIN_LIST_DEFAULT_SIZE, ADMIN_LIST_HTTP_DEFAULT_SIZE, ADMIN_LIST_MAX_SIZE, clampListSize, LIST_FIRST_PAGE, normalizeListSize, parseListPage, parseListSize, resolveListPage, } from './src/pagination.js';
 export type { LegacyPasswordVerifier, PasswordConfigInput, PasswordVerifyResult, } from './src/password/password_manager.js';
 export { PasswordManager, PasswordPolicyError, } from './src/password/password_manager.js';
 export type { PasswordPolicyViolation, ResolvedPasswordConfig, ResolvedPasswordPolicy, } from './src/password/policy.js';

package/build/index.js

@@ -101,6 +101,7 @@ export { withMfa } from './src/mixins/with_mfa.js';
 export { withPersonalAccessToken } from './src/mixins/with_personal_access_token.js';
 export { withProviderIdentity } from './src/mixins/with_provider_identity.js';
 export { withWebauthnCredential } from './src/mixins/with_webauthn_credential.js';
+export { ADMIN_LIST_DEFAULT_SIZE, ADMIN_LIST_HTTP_DEFAULT_SIZE, ADMIN_LIST_MAX_SIZE, clampListSize, LIST_FIRST_PAGE, normalizeListSize, parseListPage, parseListSize, resolveListPage, } from './src/pagination.js';
 // Gerência de senha: lazy rehash + legacy verifier, política e checagem de vazamento.
 export { PasswordManager, PasswordPolicyError, } from './src/password/password_manager.js';
 export { checkPasswordPolicy, DEFAULT_PWNED_TIMEOUT_MS, policyViolationParams, } from './src/password/policy.js';

package/build/src/accounts/account_store.d.ts

@@ -22,14 +22,25 @@ export interface LinkProviderIdentityInput {
     providerUserId: string;
     email?: string;
 }
-/** Parâmetros de listagem paginada de contas (console admin). */
+/**
+ * Parâmetros de listagem paginada de contas (console admin).
+ *
+ * O par `{ page, size }` espelha INTENCIONALMENTE o shape de paginação por
+ * offset de `@adonis-agora/filter` (`FilterInput.page`/`.size`), para manter a
+ * mesma interface em todo o ecossistema `@adonis-agora/*`. É um casamento
+ * ESTRUTURAL: não há dependência de `@adonis-agora/filter` aqui.
+ */
 export interface ListAccountsParams {
     /** Filtro por e-mail (substring, case-insensitive). */
     search?: string;
     /** Página (1-based). Default: 1. */
     page?: number;
-    /** Itens por página. Default: 20. */
-    limit?: number;
+    /**
+     * Itens por página. Default: 20; limitado a `ADMIN_LIST_MAX_SIZE` (200).
+     *
+     * Renomeado de `limit` para `size` para casar com `@adonis-agora/filter`.
+     */
+    size?: number;
 }
 /** Página de resultados + total absoluto (para paginação na UI). */
 export interface Paginated<T> {

package/build/src/accounts/lucid_store/core.js

@@ -2,6 +2,7 @@ import { randomBytes } from 'node:crypto';
 import { Scrypt } from '@adonisjs/core/hash/drivers/scrypt';
 import { DateTime } from 'luxon';
 import { decodeOtpToken, encodeOtpToken, evaluateLoginOtp, generateOtpCode, hashLoginOtp, linkTokenFromOtpUrl, OTP_LOGIN_PREFIX, } from '../../host/otp_login.js';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, normalizeListSize, resolveListPage, } from '../../pagination.js';
 import { hasColumn } from './status_profile.js';
 import { generateExpiringHashedToken, generateHashedToken, parseExpiringTokenExp, rawToDbToken, rawToExpiringDbToken, sha256Hex, } from './token_hash.js';
 /**
@@ -361,8 +362,8 @@ export function buildCore(ctx) {
         },
         // ----- Administração (console admin) -----
         async listAccounts(params) {
-            const page = Math.max(1, params.page ?? 1);
-            const limit = Math.max(1, params.limit ?? 20);
+            const page = resolveListPage(params.page);
+            const size = normalizeListSize(params.size, ADMIN_LIST_HTTP_DEFAULT_SIZE);
             const search = params.search?.trim();
             const base = () => {
                 const q = Model.query();
@@ -377,8 +378,8 @@ export function buildCore(ctx) {
             const total = Number(countResult[0]?.$extras?.total ?? 0);
             const rows = await base()
                 .orderBy('email', 'asc')
-                .offset((page - 1) * limit)
-                .limit(limit);
+                .offset((page - 1) * size)
+                .limit(size);
             return { data: rows.map(toAccount), total };
         },
         async setGlobalRoles(accountId, roles) {

package/build/src/audit/audit_sink.d.ts

@@ -42,12 +42,23 @@ export interface StoredAuditEvent extends AuditEvent {
     id: string;
     createdAt: Date | string | null;
 }
-/** Filtros de listagem do log de auditoria (console admin). */
+/**
+ * Filtros de listagem do log de auditoria (console admin).
+ *
+ * O par `{ page, size }` espelha INTENCIONALMENTE o shape de paginação por
+ * offset de `@adonis-agora/filter` (`FilterInput.page`/`.size`), para manter a
+ * mesma interface em todo o ecossistema `@adonis-agora/*`. É um casamento
+ * ESTRUTURAL: não há dependência de `@adonis-agora/filter` aqui.
+ */
 export interface ListAuditParams {
     /** Página (1-based). Default: 1. */
     page?: number;
-    /** Itens por página. Default: 20. */
-    limit?: number;
+    /**
+     * Itens por página. Default: 20; limitado a `ADMIN_LIST_MAX_SIZE` (200).
+     *
+     * Renomeado de `limit` para `size` para casar com `@adonis-agora/filter`.
+     */
+    size?: number;
     /** Filtra por tipo de evento exato. */
     type?: string;
     /** Filtra pelo subject (accountId) do evento. */

package/build/src/audit/lucid_audit_sink.js

@@ -1,4 +1,5 @@
 import { createHash } from 'node:crypto';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, normalizeListSize, resolveListPage } from '../pagination.js';
 /**
  * Pseudônimo estável para um accountId anonimizado: `anon:<sha256(accountId)[:16]>`.
  * Mantém os eventos de uma conta deletada correlacionáveis ENTRE SI (mesmo
@@ -35,8 +36,8 @@ export function lucidAuditSink(Model) {
             }
         },
         async list(params) {
-            const page = Math.max(1, params.page ?? 1);
-            const limit = Math.max(1, params.limit ?? 20);
+            const page = resolveListPage(params.page);
+            const size = normalizeListSize(params.size, ADMIN_LIST_HTTP_DEFAULT_SIZE);
             const base = () => {
                 const q = Model.query();
                 if (params.type)
@@ -49,8 +50,8 @@ export function lucidAuditSink(Model) {
             const total = Number(countResult[0]?.$extras?.total ?? 0);
             const rows = await base()
                 .orderBy('createdAt', 'desc')
-                .offset((page - 1) * limit)
-                .limit(limit);
+                .offset((page - 1) * size)
+                .limit(size);
             const data = rows.map((row) => ({
                 id: String(row.id),
                 type: row.type,

package/build/src/commands/expire_scan_command.js

@@ -29,6 +29,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 import { RuntimeSettings } from '../host/runtime_settings.js';
 import { resolveEffectiveAccountExpiration } from '../host/runtime_toggles.js';
+import { ADMIN_LIST_DEFAULT_SIZE, LIST_FIRST_PAGE } from '../pagination.js';
 import { resolveAuthkitConfig } from './resolve_config.js';
 // ---------------------------------------------------------------------------
 // Core logic (pura, testável sem Ace)
@@ -76,10 +77,10 @@ export async function runExpireScan(app, opts) {
     let warnedCount = 0;
     let dedupedCount = 0;
     let scanned = 0;
-    let page = 1;
-    const limit = 100;
+    let page = LIST_FIRST_PAGE;
+    const size = ADMIN_LIST_DEFAULT_SIZE;
     while (true) {
-        const batch = await accountStore.listAccounts({ page, limit });
+        const batch = await accountStore.listAccounts({ page, size });
         if (batch.data.length === 0)
             break;
         for (const account of batch.data) {
@@ -127,7 +128,7 @@ export async function runExpireScan(app, opts) {
                 }
             }
         }
-        if (batch.data.length < limit)
+        if (batch.data.length < size)
             break;
         page++;
     }
@@ -157,8 +158,8 @@ async function getLastLoginMs(audit, accountId) {
         const result = await audit.list({
             type: 'login.success',
             subject: accountId,
-            page: 1,
-            limit: 1,
+            page: LIST_FIRST_PAGE,
+            size: 1,
         });
         if (result.data.length === 0)
             return null;
@@ -181,8 +182,8 @@ async function wasWarnedRecently(audit, accountId, warnDays) {
         const result = await audit.list({
             type: 'account.expiration_warned',
             subject: accountId,
-            page: 1,
-            limit: 1,
+            page: LIST_FIRST_PAGE,
+            size: 1,
         });
         if (result.data.length === 0)
             return false;

package/build/src/host/account_export_service.js

@@ -1,7 +1,8 @@
 import { supportsOrganizations, supportsPasskeys, supportsProviderIdentity, } from '../accounts/account_store.js';
+import { LIST_FIRST_PAGE } from '../pagination.js';
 import { AdminSessionsService } from './admin_sessions_service.js';
 /** Limite de eventos de audit incluídos no export (evita payloads gigantes). */
-const AUDIT_EXPORT_LIMIT = 1000;
+const AUDIT_EXPORT_SIZE = 1000;
 /**
  * Monta o pacote de dados de uma conta para portabilidade (LGPD/GDPR). NUNCA
  * inclui segredos: hash de senha, segredo TOTP, recovery codes, chave pública de
@@ -102,8 +103,8 @@ export class AccountExportService {
             try {
                 const page = await cfg.audit.list({
                     subject: accountId,
-                    page: 1,
-                    limit: AUDIT_EXPORT_LIMIT,
+                    page: LIST_FIRST_PAGE,
+                    size: AUDIT_EXPORT_SIZE,
                 });
                 auditLog = page.data.map((e) => ({
                     type: e.type,

package/build/src/host/admin_api/admin_orgs_service.js

@@ -1,4 +1,5 @@
 import { supportsOrganizations } from '../../accounts/account_store.js';
+import { ADMIN_LIST_DEFAULT_SIZE, LIST_FIRST_PAGE } from '../../pagination.js';
 import { accountPath } from '../account_paths.js';
 import { sendOrgInvitationEmail } from '../default_mailer.js';
 import { isRoleInCatalog, resolveRoleCatalogList } from '../runtime_toggles.js';
@@ -50,14 +51,14 @@ export class AdminOrgsService {
         // O store não tem listAllOrgs — acumulamos via memberships de todas as contas.
         // Para admin, fazemos um listAccounts full e coletamos todas as orgs únicas.
         // Mais eficiente: usa a tabela de organizations diretamente pelo listOrgMembers
-        // mas o store não expõe listAllOrgs. Usamos hack: listAccounts com limit alto,
+        // mas o store não expõe listAllOrgs. Usamos hack: listAccounts com size alto,
         // coletamos orgs via listOrgsForAccount por conta.
         // Para evitar N+1 excessivo, usamos uma abordagem "seen" de IDs.
         const seen = new Map();
-        let page = 1;
-        const limit = 100;
+        let page = LIST_FIRST_PAGE;
+        const size = ADMIN_LIST_DEFAULT_SIZE;
         while (true) {
-            const result = await store.listAccounts({ page, limit });
+            const result = await store.listAccounts({ page, size });
             for (const account of result.data) {
                 const orgs = await store.listOrgsForAccount(account.id);
                 for (const org of orgs) {
@@ -68,7 +69,7 @@ export class AdminOrgsService {
                     }
                 }
             }
-            if (result.data.length < limit)
+            if (result.data.length < size)
                 break;
             page++;
         }

package/build/src/host/admin_api/admin_users_service.d.ts

@@ -121,12 +121,12 @@ export declare class AdminUsersService {
      * conta é contada no máximo uma vez via {@link hasAdminRole}).
      *
      * Terminadores honestos (sem número mágico): a paginação para quando
-     *   - a página veio incompleta (`data.length < pageSize`) → última página, OU
+     *   - a página veio incompleta (`data.length < size`) → última página, OU
      *   - a página veio vazia (`data.length === 0`) → sem mais dados, OU
-     *   - já cobrimos o total reportado (`page * pageSize >= total`).
+     *   - já cobrimos o total reportado (`page * size >= total`).
      * Uma página COMPLETA com `total` ainda maior continua paginando. Isto encerra
      * de forma garantida para qualquer store que devolva páginas finitas (a última
-     * página é, por definição, menor que `pageSize` ou vazia).
+     * página é, por definição, menor que `size` ou vazia).
      */
     private countAdminsByScan;
     /**

package/build/src/host/admin_api/admin_users_service.js

@@ -1,5 +1,6 @@
 import { randomBytes } from 'node:crypto';
 import { supportsAccountDeletion, supportsAccountStatus, supportsCountByGlobalRole, supportsProfile, } from '../../accounts/account_store.js';
+import { ADMIN_LIST_DEFAULT_SIZE, LIST_FIRST_PAGE } from '../../pagination.js';
 import { PasswordPolicyError } from '../../password/password_manager.js';
 import { AccountDeletionService } from '../account_deletion_service.js';
 import { sendPasswordResetEmail } from '../default_mailer.js';
@@ -179,28 +180,28 @@ export class AdminUsersService {
      * conta é contada no máximo uma vez via {@link hasAdminRole}).
      *
      * Terminadores honestos (sem número mágico): a paginação para quando
-     *   - a página veio incompleta (`data.length < pageSize`) → última página, OU
+     *   - a página veio incompleta (`data.length < size`) → última página, OU
      *   - a página veio vazia (`data.length === 0`) → sem mais dados, OU
-     *   - já cobrimos o total reportado (`page * pageSize >= total`).
+     *   - já cobrimos o total reportado (`page * size >= total`).
      * Uma página COMPLETA com `total` ainda maior continua paginando. Isto encerra
      * de forma garantida para qualquer store que devolva páginas finitas (a última
-     * página é, por definição, menor que `pageSize` ou vazia).
+     * página é, por definição, menor que `size` ou vazia).
      */
     async countAdminsByScan() {
         const store = this.cfg.accountStore;
-        const pageSize = 100;
-        let page = 1;
+        const size = ADMIN_LIST_DEFAULT_SIZE;
+        let page = LIST_FIRST_PAGE;
         let count = 0;
         while (true) {
             const { data, total } = await store.listAccounts({
                 page,
-                limit: pageSize,
+                size,
             });
             for (const acc of data) {
                 if (this.hasAdminRole(acc.globalRoles ?? []))
                     count++;
             }
-            if (data.length < pageSize || page * pageSize >= total)
+            if (data.length < size || page * size >= total)
                 break;
             page++;
         }

package/build/src/host/admin_api/api_misc_controller.d.ts

@@ -5,12 +5,14 @@ import type { HttpContext } from '@adonisjs/core/http';
  * introspecção genérica de token (`POST /tokens/verify`).
  */
 export default class ApiMiscController {
-    /** GET /audit — listagem paginada (501 JSON quando o sink não consulta). */
+    /** GET /audit — `{ meta: { page, size, total }, data }` (501 JSON quando o sink não consulta). */
     audit(ctx: HttpContext): Promise<void | {
+        meta: {
+            page: number;
+            size: number;
+            total: any;
+        };
         data: any;
-        total: any;
-        page: number;
-        limit: number;
     }>;
     /** GET /stats — métricas-resumo do IdP (totais + MAU + séries de 30 dias). */
     stats(ctx: HttpContext): Promise<import("../admin_stats_service.js").AdminStats>;

package/build/src/host/admin_api/api_misc_controller.js

@@ -1,4 +1,5 @@
 import '../augmentations.js';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, parseListPage, parseListSize } from '../../pagination.js';
 import { AdminSessionsService } from '../admin_sessions_service.js';
 import { computeAdminStats } from '../admin_stats_service.js';
 import { tokenVerifyValidator } from '../admin_validators.js';
@@ -9,7 +10,7 @@ import { TokenVerifyService } from './token_verify_service.js';
  * introspecção genérica de token (`POST /tokens/verify`).
  */
 export default class ApiMiscController {
-    /** GET /audit — listagem paginada (501 JSON quando o sink não consulta). */
+    /** GET /audit — `{ meta: { page, size, total }, data }` (501 JSON quando o sink não consulta). */
     async audit(ctx) {
         const service = await ctx.containerResolver.make('authkit.server');
         const cfg = service.config;
@@ -19,12 +20,12 @@ export default class ApiMiscController {
                 .status(501)
                 .send(apiError('not_implemented', 'O sink de auditoria configurado não suporta consulta.'));
         }
-        const page = Math.max(1, Number.parseInt(ctx.request.input('page', '1'), 10) || 1);
-        const limit = Math.max(1, Math.min(100, Number.parseInt(ctx.request.input('limit', '20'), 10) || 20));
+        const page = parseListPage(ctx.request.input('page'));
+        const size = parseListSize(ctx.request.input('size'), ADMIN_LIST_HTTP_DEFAULT_SIZE);
         const type = ctx.request.input('type')?.trim() || undefined;
         const subject = ctx.request.input('subject')?.trim() || undefined;
-        const result = await sink.list({ page, limit, type, subject });
-        return { data: result.data.map(auditDto), total: result.total, page, limit };
+        const result = await sink.list({ page, size, type, subject });
+        return { meta: { page, size, total: result.total }, data: result.data.map(auditDto) };
     }
     /** GET /stats — métricas-resumo do IdP (totais + MAU + séries de 30 dias). */
     async stats(ctx) {

package/build/src/host/admin_api/api_users_controller.d.ts

@@ -6,12 +6,14 @@ import type { HttpContext } from '@adonisjs/core/http';
  */
 export default class ApiUsersController {
     #private;
-    /** GET /users — listagem paginada com busca por e-mail. */
+    /** GET /users — `{ meta: { page, size, total }, data }`, com busca por e-mail. */
     index(ctx: HttpContext): Promise<{
+        meta: {
+            page: number;
+            size: number;
+            total: any;
+        };
         data: any[];
-        total: any;
-        page: number;
-        limit: number;
     }>;
     /** GET /users/:id */
     show(ctx: HttpContext): Promise<void | {

package/build/src/host/admin_api/api_users_controller.js

@@ -1,11 +1,11 @@
 import '../augmentations.js';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, parseListPage, parseListSize } from '../../pagination.js';
 import { AdminSessionsService } from '../admin_sessions_service.js';
 import { adminUserCreateValidator, adminUserUpdateValidator } from '../admin_validators.js';
 import { resolveRuntimeSettings } from '../runtime_settings.js';
 import { enrichSessionsWithContext } from '../session_context.js';
 import { AdminUsersService } from './admin_users_service.js';
 import { apiError, grantDto, sessionDto, userDto } from './dto.js';
-const PAGE_SIZE = 20;
 /**
  * Lê a config + monta o actor `admin-api` para auditoria. O `actorId` recebe o
  * id NÃO-SENSÍVEL da API key que autenticou (anexado pelo `adminApiGuard` em
@@ -27,16 +27,16 @@ async function ctxBits(ctx) {
  * envelope `{ error: { code, message } }`. Toda escrita audita com `actor: 'admin-api'`.
  */
 export default class ApiUsersController {
-    /** GET /users — listagem paginada com busca por e-mail. */
+    /** GET /users — `{ meta: { page, size, total }, data }`, com busca por e-mail. */
     async index(ctx) {
         const { cfg } = await ctxBits(ctx);
         const search = ctx.request.input('search', '').trim();
-        const page = Math.max(1, Number.parseInt(ctx.request.input('page', '1'), 10) || 1);
-        const limit = Math.max(1, Math.min(100, Number.parseInt(ctx.request.input('limit', String(PAGE_SIZE)), 10) || PAGE_SIZE));
-        const result = await cfg.accountStore.listAccounts({ search, page, limit });
+        const page = parseListPage(ctx.request.input('page'));
+        const size = parseListSize(ctx.request.input('size'), ADMIN_LIST_HTTP_DEFAULT_SIZE);
+        const result = await cfg.accountStore.listAccounts({ search, page, size });
         const users = new AdminUsersService(cfg);
         const data = await Promise.all(result.data.map(async (u) => userDto(u, await users.isDisabled(u.id))));
-        return { data, total: result.total, page, limit };
+        return { meta: { page, size, total: result.total }, data };
     }
     /** GET /users/:id */
     async show(ctx) {

package/build/src/host/admin_console/console_audit_controller.d.ts

@@ -3,15 +3,17 @@ import type { HttpContext } from '@adonisjs/core/http';
 /**
  * Endpoints JSON do log de auditoria do console admin React.
  *
- * GET {prefix}/api/audit?type=&page=&limit=  → listagem paginada
+ * GET {prefix}/api/audit?type=&page=&size=  → `{ meta: { page, size, total }, data }`
  *
  * 404 honesto (`capability_unsupported`) quando o sink não suporta consulta.
  */
 export default class ConsoleAuditController {
     index(ctx: HttpContext): Promise<void | {
+        meta: {
+            page: number;
+            size: number;
+            total: any;
+        };
         data: any;
-        total: any;
-        page: number;
-        limit: number;
     }>;
 }

package/build/src/host/admin_console/console_audit_controller.js

@@ -1,9 +1,10 @@
 import '../augmentations.js';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, parseListPage, parseListSize } from '../../pagination.js';
 import { apiError, auditDto } from '../admin_api/dto.js';
 /**
  * Endpoints JSON do log de auditoria do console admin React.
  *
- * GET {prefix}/api/audit?type=&page=&limit=  → listagem paginada
+ * GET {prefix}/api/audit?type=&page=&size=  → `{ meta: { page, size, total }, data }`
  *
  * 404 honesto (`capability_unsupported`) quando o sink não suporta consulta.
  */
@@ -15,11 +16,11 @@ export default class ConsoleAuditController {
         if (!sink || typeof sink.list !== 'function') {
             return ctx.response.notFound(apiError('capability_unsupported', 'O sink de auditoria configurado não suporta consulta.'));
         }
-        const page = Math.max(1, Number.parseInt(ctx.request.input('page', '1'), 10) || 1);
-        const limit = Math.max(1, Math.min(100, Number.parseInt(ctx.request.input('limit', '20'), 10) || 20));
+        const page = parseListPage(ctx.request.input('page'));
+        const size = parseListSize(ctx.request.input('size'), ADMIN_LIST_HTTP_DEFAULT_SIZE);
         const type = ctx.request.input('type')?.trim() || undefined;
         const subject = ctx.request.input('subject')?.trim() || undefined;
-        const result = await sink.list({ page, limit, type, subject });
-        return { data: result.data.map(auditDto), total: result.total, page, limit };
+        const result = await sink.list({ page, size, type, subject });
+        return { meta: { page, size, total: result.total }, data: result.data.map(auditDto) };
     }
 }

package/build/src/host/admin_console/console_overview_controller.js

@@ -1,4 +1,5 @@
 import '../augmentations.js';
+import { LIST_FIRST_PAGE } from '../../pagination.js';
 import { AdminSessionsService } from '../admin_sessions_service.js';
 import { computeAdminStats } from '../admin_stats_service.js';
 /**
@@ -17,7 +18,9 @@ export default class ConsoleOverviewController {
         const sessions = new AdminSessionsService(service);
         const stats = await computeAdminStats(cfg, sessions);
         const clientsCount = cfg.clients.length;
-        const recentResult = typeof cfg.audit?.list === 'function' ? await cfg.audit.list({ page: 1, limit: 5 }) : null;
+        const recentResult = typeof cfg.audit?.list === 'function'
+            ? await cfg.audit.list({ page: LIST_FIRST_PAGE, size: 5 })
+            : null;
         return {
             usersTotal: stats.totalUsers,
             activeSessions: stats.activeSessions,

package/build/src/host/admin_console/console_users_controller.d.ts

@@ -3,7 +3,7 @@ import type { HttpContext } from '@adonisjs/core/http';
 /**
  * Endpoints JSON de usuários do console admin React.
  *
- * GET  {prefix}/api/users?search=&page=&perPage=  → lista paginada + roles
+ * GET  {prefix}/api/users?search=&page=&size=  → `{ meta: { page, size, total }, data }`
  * GET  {prefix}/api/users/:id                     → detalhe + sessões + identidades + MFA status
  * POST {prefix}/api/users                         → criar usuário
  * PATCH {prefix}/api/users/:id/roles              → substituir roles globais
@@ -20,10 +20,12 @@ export default class ConsoleUsersController {
     #private;
     /** GET {prefix}/api/users */
     index(ctx: HttpContext): Promise<{
+        meta: {
+            page: number;
+            size: number;
+            total: any;
+        };
         data: any[];
-        total: any;
-        page: number;
-        perPage: number;
     }>;
     /** GET {prefix}/api/users/:id */
     show(ctx: HttpContext): Promise<void | {

package/build/src/host/admin_console/console_users_controller.js

@@ -1,5 +1,6 @@
 import '../augmentations.js';
 import { supportsAccountDeletion, supportsAccountStatus } from '../../accounts/account_store.js';
+import { ADMIN_LIST_HTTP_DEFAULT_SIZE, parseListPage, parseListSize } from '../../pagination.js';
 import { ACCOUNT_SESSION_KEY } from '../account_session_key.js';
 import { AdminUsersService } from '../admin_api/admin_users_service.js';
 import { apiError, grantDto, sessionDto, userDto } from '../admin_api/dto.js';
@@ -9,7 +10,6 @@ import { resolveRuntimeSettings } from '../runtime_settings.js';
 import { resolveEffectiveRolesCatalog } from '../runtime_toggles.js';
 import { enrichSessionsWithContext } from '../session_context.js';
 import { requireSudo } from '../sudo_mode.js';
-const PAGE_SIZE = 20;
 /**
  * Gate de sudo (M9) para ações destrutivas do console (delete user, disable,
  * reset-password): exige confirmação de identidade RECENTE do próprio admin
@@ -34,7 +34,7 @@ async function gateSudo(ctx) {
 /**
  * Endpoints JSON de usuários do console admin React.
  *
- * GET  {prefix}/api/users?search=&page=&perPage=  → lista paginada + roles
+ * GET  {prefix}/api/users?search=&page=&size=  → `{ meta: { page, size, total }, data }`
  * GET  {prefix}/api/users/:id                     → detalhe + sessões + identidades + MFA status
  * POST {prefix}/api/users                         → criar usuário
  * PATCH {prefix}/api/users/:id/roles              → substituir roles globais
@@ -53,16 +53,16 @@ export default class ConsoleUsersController {
         const service = await ctx.containerResolver.make('authkit.server');
         const cfg = service.config;
         const search = ctx.request.input('search', '').trim();
-        const page = Math.max(1, Number.parseInt(ctx.request.input('page', '1'), 10) || 1);
-        const perPage = Math.max(1, Math.min(100, Number.parseInt(ctx.request.input('perPage', String(PAGE_SIZE)), 10) || PAGE_SIZE));
+        const page = parseListPage(ctx.request.input('page'));
+        const size = parseListSize(ctx.request.input('size'), ADMIN_LIST_HTTP_DEFAULT_SIZE);
         const result = await cfg.accountStore.listAccounts({
             search,
             page,
-            limit: perPage,
+            size,
         });
         const users = new AdminUsersService(cfg);
         const data = await Promise.all(result.data.map(async (u) => userDto(u, await users.isDisabled(u.id))));
-        return { data, total: result.total, page, perPage };
+        return { meta: { page, size, total: result.total }, data };
     }
     /** GET {prefix}/api/users/:id */
     async show(ctx) {

package/build/src/host/admin_stats_service.js

@@ -1,3 +1,4 @@
+import { ADMIN_LIST_MAX_SIZE, LIST_FIRST_PAGE } from '../pagination.js';
 /** Janela de agregação (dias). */
 const WINDOW_DAYS = 30;
 /**
@@ -19,7 +20,8 @@ const MAX_EVENTS = 10000;
  * nativa e expor um `stats()` próprio no futuro.
  */
 export async function computeAdminStats(cfg, sessionsService) {
-    const totalUsers = (await cfg.accountStore.listAccounts({ page: 1, limit: 1 })).total;
+    const totalUsers = (await cfg.accountStore.listAccounts({ page: LIST_FIRST_PAGE, size: 1 }))
+        .total;
     const activeSessions = sessionsService.canList
         ? await sessionsService.countActiveSessions()
         : null;
@@ -65,10 +67,10 @@ export async function computeAdminStats(cfg, sessionsService) {
  */
 async function loadEventsInWindow(audit, type, windowStartMs) {
     const out = [];
-    const limit = 200;
-    let page = 1;
+    const size = ADMIN_LIST_MAX_SIZE;
+    let page = LIST_FIRST_PAGE;
     while (out.length < MAX_EVENTS) {
-        const result = await audit.list({ type, page, limit });
+        const result = await audit.list({ type, page, size });
         if (result.data.length === 0)
             break;
         let allBelowWindow = true;
@@ -86,7 +88,7 @@ async function loadEventsInWindow(audit, type, windowStartMs) {
         // Página inteira anterior à janela → não há mais nada relevante (ordem desc).
         if (allBelowWindow)
             break;
-        if (result.data.length < limit)
+        if (result.data.length < size)
             break;
         page += 1;
     }