@adonis-agora/authkit-server 0.47.0 → 0.49.0

package/build/src/host/account_paths.js

@@ -0,0 +1,161 @@
+/**
+ * Prefixo e segmentos de tela do console de conta (`/account/*`) — singleton de
+ * processo, configurável/localizável.
+ *
+ * Definidos em tempo de registro das rotas (`registerAuthHost`, via a opção
+ * `accountRoutes`) e lidos em runtime por TODOS os pontos que constroem uma URL
+ * do console de conta: o registro de rotas, os redirects dos controllers, as
+ * URLs absolutas dos e-mails transacionais, os guards de sudo e as views Edge
+ * (injetados como prop global `accountPaths` pelo renderer).
+ *
+ * Por que módulo singleton e não binding do container? Mesma razão do
+ * `admin_prefix` e do `account_login_url`: os guards e o registro de rotas são
+ * closures construídas em tempo de registro, ANTES da primeira request, quando
+ * o container do AdonisJS ainda não existe. Um módulo ESM é inicializado uma vez
+ * por processo — ideal para configuração imutável de boot.
+ *
+ * ── O que é configurável e o que NÃO é ──────────────────────────────────────
+ * Configuráveis: o PREFIXO (`/account` → `/conta`) e o SEGMENTO de cada TELA
+ * navegável (`security` → `seguranca`, `confirm` → `confirmar`, ...). São paths
+ * que o usuário vê na barra de endereço e que um host pode querer no idioma dele.
+ *
+ * NÃO configuráveis (de propósito): os action-subpaths dos POSTs de dentro de
+ * cada tela — `/password`, `/email`, `/enroll`, `/confirm`, `/disable`,
+ * `/passkeys/options`, `/passkeys/verify`, `/delete`, `/export`, o `/magic-link`
+ * e o `/passkey` das rotas de sudo, etc. São endpoints de formulário invisíveis
+ * ao usuário (ele nunca digita `/account/security/password`), servem apenas de
+ * alvo de `<form action>`/`fetch`, e mantê-los fixos evita multiplicar a
+ * superfície de configuração (e a de bugs) sem nenhum ganho de UX. Renomear a
+ * tela já cobre o caso real "quero /conta/seguranca". Idem para o segmento fixo
+ * `api` da JSON API (`{prefix}/api/*`): ele segue o prefixo mas nunca é
+ * traduzido — é contrato de máquina (authkit-react), não de humano.
+ */
+/** Prefixo default do console de conta. */
+const DEFAULT_ACCOUNT_PREFIX = '/account';
+/**
+ * Segmentos default de cada TELA navegável do console de conta. A chave é o
+ * identificador estável usado no código (`accountPath('security')`); o valor é
+ * o segmento de URL, sobrescrevível por `setAccountPaths`.
+ */
+const DEFAULT_ACCOUNT_SEGMENTS = {
+    login: 'login',
+    logout: 'logout',
+    security: 'security',
+    mfa: 'mfa',
+    confirm: 'confirm',
+    tokens: 'tokens',
+    apps: 'apps',
+    orgs: 'orgs',
+    emailConfirm: 'email/confirm',
+};
+let _prefix = DEFAULT_ACCOUNT_PREFIX;
+let _segments = { ...DEFAULT_ACCOUNT_SEGMENTS };
+/**
+ * Normaliza o prefixo: começa com '/', sem trailing slash. Mesma semântica de
+ * `normalizeAdminPrefix`. `'/'` → `'/'` (raiz) é improvável mas seguro.
+ */
+export function normalizeAccountPrefix(raw) {
+    let p = raw.trim();
+    if (!p.startsWith('/'))
+        p = `/${p}`;
+    p = p.replace(/\/+$/, '');
+    return p || '/';
+}
+/**
+ * Normaliza um segmento de tela: sem barras nas pontas (mas preserva barras
+ * internas, ex.: `'email/confirm'`). Valor vazio é ignorado pelo caller.
+ */
+function normalizeSegment(raw) {
+    return raw.trim().replace(/^\/+/, '').replace(/\/+$/, '');
+}
+/**
+ * Define o prefixo e/ou os segmentos de tela do console de conta para este
+ * processo. Chamado UMA VEZ por `registerAuthHost` no boot da aplicação.
+ *
+ * Só sobrescreve o que foi passado — chamada sem `prefix` mantém o prefixo
+ * atual, e segmentos ausentes de `paths` mantêm o default. Valores
+ * vazios/whitespace são ignorados (caem no default), nunca produzem um path
+ * quebrado.
+ *
+ * @example
+ * setAccountPaths({ prefix: '/conta', paths: { security: 'seguranca', confirm: 'confirmar' } })
+ * accountPath('security') // → '/conta/seguranca'
+ * accountPath('confirm')  // → '/conta/confirmar'
+ */
+export function setAccountPaths(opts) {
+    if (!opts)
+        return;
+    if (opts.prefix !== undefined) {
+        const trimmed = opts.prefix.trim();
+        if (trimmed)
+            _prefix = normalizeAccountPrefix(trimmed);
+    }
+    if (opts.paths) {
+        for (const key of Object.keys(opts.paths)) {
+            const value = opts.paths[key];
+            if (value === undefined)
+                continue;
+            const seg = normalizeSegment(value);
+            if (seg)
+                _segments[key] = seg;
+        }
+    }
+}
+/**
+ * Junta o prefixo do console de conta com um subpath arbitrário, tratando o
+ * prefixo raiz (`'/'`) como `''` na composição: sem isso o resultado seria
+ * `'//<sub>'`, que num `<form action>`/`fetch()` é URL protocol-relative (o
+ * browser lê `<sub>` como HOST, não como path).
+ *
+ * Base canônica de `accountPath()` e de QUALQUER outra composição
+ * prefixo+subpath fora das TELAS fixas (ex.: o `{prefix}/api` da JSON API em
+ * `register_auth_host`). Novas composições devem passar por aqui em vez de
+ * reimplementar `${accountPrefix()}/algo` — é exatamente essa duplicação que
+ * reproduz o bug do `//` quando o prefixo normaliza pra raiz.
+ *
+ * @example
+ * joinAccountPath('api') // default → '/account/api'
+ */
+export function joinAccountPath(sub) {
+    const base = _prefix === '/' ? '' : _prefix;
+    return `${base}/${sub}`;
+}
+/**
+ * Retorna o path completo de uma TELA do console de conta (prefixo + segmento).
+ * Para os action-subpaths (POSTs de dentro da tela) concatene o subpath fixo:
+ * `accountPath('security') + '/password'`.
+ *
+ * @example
+ * accountPath('security') // default → '/account/security'
+ * accountPath('confirm')  // default → '/account/confirm'
+ */
+export function accountPath(key) {
+    return joinAccountPath(_segments[key]);
+}
+/**
+ * Retorna o prefixo BRUTO do console de conta (default `'/account'`; pode ser
+ * `'/'` na raiz). Para compor `{prefix}/algo` (ex.: a JSON API, cujo segmento
+ * `api` é fixo — contrato de máquina), use `joinAccountPath('algo')`: ela
+ * colapsa a raiz e evita o `//`. Este getter existe para os casos (ex.: os
+ * asserts de teste) que precisam do valor cru do prefixo.
+ */
+export function accountPrefix() {
+    return _prefix;
+}
+/**
+ * Mapa `{ chave → path completo }` de TODAS as telas. Injetado como prop global
+ * `accountPaths` nas views Edge, para que os `<form action>`/`fetch()` respeitem
+ * os overrides sem cada view conhecer o prefixo.
+ */
+export function accountPathsMap() {
+    const out = {};
+    for (const key of Object.keys(_segments)) {
+        out[key] = accountPath(key);
+    }
+    return out;
+}
+/** Restaura os defaults — uso em testes (isola o singleton entre casos). */
+export function resetAccountPaths() {
+    _prefix = DEFAULT_ACCOUNT_PREFIX;
+    _segments = { ...DEFAULT_ACCOUNT_SEGMENTS };
+}

package/build/src/host/account_screen_props.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Tipos de props das telas do console de conta (`/account/*`) — a FONTE ÚNICA da
+ * verdade sobre o shape que cada página React recebe.
+ *
+ * ── Por que esses tipos existem ──────────────────────────────────────────────
+ * Um host que cria as telas do console em React próprio (via `inertiaRenderer`,
+ * em vez das views Edge built-in) precisa tipar o componente da página. Antes
+ * disso, o único "contrato" era o DOCBLOCK do `inertiaRenderer`, copiado à mão —
+ * frágil: um docblock desatualizado já enganou um host. Agora o shape vem daqui,
+ * e os CONTROLLERS REAIS (`account_session_controller`, `account_security_-
+ * controller`, `account_mfa_controller`, `account_confirm_controller`) satisfazem
+ * (`satisfies Omit<…, 'messages'>`) exatamente estes tipos ao chamar `render()`.
+ * Se o payload de um controller divergir do tipo — campo a mais, a menos, tipo
+ * trocado — o `tsc` do pacote quebra. Esse é o objetivo: um único ponto muda, e
+ * o compilador força o outro a acompanhar.
+ *
+ * ── Sobre a prop `messages` ──────────────────────────────────────────────────
+ * `messages` (catálogo i18n) é injetada pelo `inertiaRenderer` como shared prop,
+ * NÃO pelos controllers. Por isso ela faz parte destes tipos (é o que a página
+ * React recebe), mas os controllers satisfazem `Omit<…, 'messages'>` — eles nunca
+ * passam `messages` no literal do `render()`.
+ */
+import type { PasskeySummary } from '../accounts/account_store.js';
+import type { AuthMessages } from './i18n.js';
+import type { SudoMethodDescriptor } from './sudo/types.js';
+/**
+ * Props da tela `account/login` (tela de login do console de conta).
+ *
+ * - `csrfToken`: token para o campo `_csrf` do formulário.
+ * - `returnTo`: caminho interno de destino pós-login (já validado pelo servidor —
+ *   só caminhos internos) ou `null`. Quando presente, o formulário deve incluir
+ *   `<input type="hidden" name="return_to" value={returnTo} />`; o servidor
+ *   revalida no POST.
+ * - `error`: mensagem de erro de autenticação localizada (credenciais inválidas,
+ *   conta bloqueada/desabilitada). Ausente quando não há erro.
+ * - `messages`: catálogo i18n (injetado pelo renderer).
+ */
+export interface AccountLoginProps {
+    csrfToken: string;
+    returnTo: string | null;
+    error?: string;
+    messages: AuthMessages;
+}
+/**
+ * Props da tela `account/security` (perfil, senha, e-mail, sessões, export,
+ * danger-zone). Todas as flags de `*Supported` degradam a UI quando o store não
+ * suporta a capacidade correspondente.
+ *
+ * - `supported`: `false` quando o store não suporta o self-service de segurança.
+ * - `profileSupported`: `true` quando dá para editar nome/avatar (`updateProfile`).
+ * - `avatarUploadSupported`: `true` quando algum backend (drive OU media) armazena o upload.
+ * - `email` / `name` / `avatarUrl`: valores atuais da conta (`''` se ausentes).
+ * - `passwordChanged` / `emailChangeRequested` / `emailChanged` / `profileUpdated`
+ *   / `error` / `trustedDevicesRevoked` / `deleteError`: flashes localizados ou `null`.
+ * - `trustedDevicesEnabled`: recurso de dispositivos confiáveis ligado.
+ * - `sessionsSupported`: `true` quando o adapter OIDC enumera as sessões ativas.
+ * - `sessions`: sessões ativas da própria conta (vazio quando não suportado).
+ *   `loginTs` é ISO ou `''`.
+ * - `exportSupported`: sempre `true` (portabilidade/LGPD para a conta logada).
+ * - `deletionSupported`: `true` quando o store suporta hard delete.
+ * - `messages`: catálogo i18n (injetado pelo renderer).
+ */
+export interface AccountSecurityProps {
+    csrfToken: string;
+    supported: boolean;
+    profileSupported: boolean;
+    avatarUploadSupported: boolean;
+    email: string;
+    name: string;
+    avatarUrl: string;
+    passwordChanged: string | null;
+    emailChangeRequested: string | null;
+    emailChanged: string | null;
+    profileUpdated: string | null;
+    error: string | null;
+    trustedDevicesEnabled: boolean;
+    trustedDevicesRevoked: string | null;
+    sessionsSupported: boolean;
+    sessions: Array<{
+        loginTs: string;
+        browser: string;
+        os: string;
+        ip: string;
+        location: string;
+    }>;
+    exportSupported: boolean;
+    deletionSupported: boolean;
+    deleteError: string | null;
+    messages: AuthMessages;
+}
+/**
+ * Props da tela `account/mfa` (TOTP + passkeys). As props VARIAM por action, e é
+ * por isso que as específicas de passo são opcionais:
+ *
+ * - `index` manda o estado base + a lista de passkeys (`passkeysSupported` /
+ *   `passkeys`).
+ * - `enroll` (após `POST /mfa/enroll`) acrescenta o passo do QR: `enrolling: true`,
+ *   `secret` (base32 para entrada manual) e `qrDataUrl` (data-URL do `otpauth://`).
+ * - `confirm` com código inválido reexibe `enrolling: true` + `error`, com
+ *   `secret`/`qrDataUrl` `null` (o segredo pendente NÃO é regenerado).
+ *
+ * - `enabled`: `true` quando o TOTP já está confirmado.
+ * - `recoveryCodes`: códigos recém-gerados (exibidos UMA vez) ou `null`.
+ * - `messages`: catálogo i18n (injetado pelo renderer).
+ */
+export interface AccountMfaProps {
+    csrfToken: string;
+    enabled: boolean;
+    recoveryCodes: string[] | null;
+    /** Presente em `index`: `true` quando o store persiste credenciais WebAuthn. */
+    passkeysSupported?: boolean;
+    /** Presente em `index`: passkeys cadastradas (vazio quando não suportado). */
+    passkeys?: PasskeySummary[];
+    /** Passo de enroll/confirm: `true` mostra QR/segredo + campo de código. */
+    enrolling?: boolean;
+    /** Segredo TOTP (base32) no passo de enroll; `null` na reexibição do confirm. */
+    secret?: string | null;
+    /** QR do `otpauth://` como data-URL no passo de enroll; `null` na reexibição. */
+    qrDataUrl?: string | null;
+    /** Erro localizado (ex.: código TOTP inválido no confirm). */
+    error?: string;
+    messages: AuthMessages;
+}
+/**
+ * Um método de sudo, como a tela `account/confirm` o recebe: o descritor do SPI
+ * (`SudoMethodDescriptor`) acrescido do `id` estável do método. A tela renderiza
+ * por `kind` (`form`/`action`/`redirect`/`webauthn`); `endpoint` é o POST de
+ * verificação (para `webauthn`, as options ficam em `${endpoint}/options`).
+ */
+export type AccountConfirmMethod = {
+    id: string;
+} & SudoMethodDescriptor;
+/**
+ * Props da tela `account/confirm` (sudo — confirmar identidade).
+ *
+ * - `csrfToken`: token para o POST de cada método.
+ * - `returnTo`: caminho interno de destino após confirmar (validado) ou `null`.
+ * - `error`: flash de erro da última tentativa ou `null`.
+ * - `notice`: flash informativo (ex.: "link de confirmação enviado") ou `null`.
+ * - `methods`: métodos de sudo disponíveis para a conta (ver {@link AccountConfirmMethod}).
+ * - `preferredId`: `id` do último método usado (destaque na UI) ou `null`.
+ * - `messages`: catálogo i18n (injetado pelo renderer).
+ */
+export interface AccountConfirmProps {
+    csrfToken: string;
+    returnTo: string | null;
+    error: string | null;
+    notice: string | null;
+    methods: AccountConfirmMethod[];
+    preferredId: string | null;
+    messages: AuthMessages;
+}
+/**
+ * Props da tela `account/email-confirmed` (terminal do link de troca de e-mail).
+ *
+ * - `ok`: `true` quando o token era válido e o novo e-mail foi aplicado; `false`
+ *   para token inválido/expirado ou store sem suporte.
+ * - `messages`: catálogo i18n (injetado pelo renderer).
+ */
+export interface AccountEmailConfirmedProps {
+    ok: boolean;
+    messages: AuthMessages;
+}

package/build/src/host/account_screen_props.js

@@ -0,0 +1,23 @@
+/**
+ * Tipos de props das telas do console de conta (`/account/*`) — a FONTE ÚNICA da
+ * verdade sobre o shape que cada página React recebe.
+ *
+ * ── Por que esses tipos existem ──────────────────────────────────────────────
+ * Um host que cria as telas do console em React próprio (via `inertiaRenderer`,
+ * em vez das views Edge built-in) precisa tipar o componente da página. Antes
+ * disso, o único "contrato" era o DOCBLOCK do `inertiaRenderer`, copiado à mão —
+ * frágil: um docblock desatualizado já enganou um host. Agora o shape vem daqui,
+ * e os CONTROLLERS REAIS (`account_session_controller`, `account_security_-
+ * controller`, `account_mfa_controller`, `account_confirm_controller`) satisfazem
+ * (`satisfies Omit<…, 'messages'>`) exatamente estes tipos ao chamar `render()`.
+ * Se o payload de um controller divergir do tipo — campo a mais, a menos, tipo
+ * trocado — o `tsc` do pacote quebra. Esse é o objetivo: um único ponto muda, e
+ * o compilador força o outro a acompanhar.
+ *
+ * ── Sobre a prop `messages` ──────────────────────────────────────────────────
+ * `messages` (catálogo i18n) é injetada pelo `inertiaRenderer` como shared prop,
+ * NÃO pelos controllers. Por isso ela faz parte destes tipos (é o que a página
+ * React recebe), mas os controllers satisfazem `Omit<…, 'messages'>` — eles nunca
+ * passam `messages` no literal do `render()`.
+ */
+export {};

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

@@ -1,7 +1,7 @@
+import type { OrgInvitation, OrgMember, OrgSummary } from '../../accounts/account_store.js';
 import type { ResolvedServerConfig } from '../../define_config.js';
-import type { OrgSummary, OrgMember, OrgInvitation } from '../../accounts/account_store.js';
-import type { AdminActor } from './admin_users_service.js';
 import type { SettingsCapability } from '../runtime_settings.js';
+import type { AdminActor } from './admin_users_service.js';
 export interface OrgWithMemberCount extends OrgSummary {
     memberCount: number;
 }

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

@@ -1,5 +1,6 @@
 import { supportsOrganizations } from '../../accounts/account_store.js';
-import { resolveRoleCatalogList, isRoleInCatalog } from '../runtime_toggles.js';
+import { accountPath } from '../account_paths.js';
+import { isRoleInCatalog, resolveRoleCatalogList } from '../runtime_toggles.js';
 /**
  * Lógica de gestão de organizações compartilhada entre o console admin (HTML)
  * e a Admin REST API (JSON). Usada pelos `AdminOrgsController` e `ApiOrgsController`.
@@ -267,7 +268,7 @@ export class AdminOrgsService {
         });
         // Dispara mail hook (best-effort)
         if (this.cfg.mail?.onOrgInvitation) {
-            const acceptUrl = `${origin}/account/orgs/invitations/${token}/accept`;
+            const acceptUrl = `${origin}${accountPath('orgs')}/invitations/${token}/accept`;
             try {
                 await this.cfg.mail.onOrgInvitation({
                     email: input.email,

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

@@ -1,20 +1,20 @@
-import type { HttpContext } from "@adonisjs/core/http";
-import type { ResolvedServerConfig } from "../../define_config.js";
-import type { OidcService } from "../../provider/oidc_service.js";
-import type { AuthAccount } from "../../accounts/account_store.js";
-import { type DeletionResult } from "../account_deletion_service.js";
-import type { SettingsCapability } from "../runtime_settings.js";
+import type { HttpContext } from '@adonisjs/core/http';
+import type { AuthAccount } from '../../accounts/account_store.js';
+import type { ResolvedServerConfig } from '../../define_config.js';
+import type { OidcService } from '../../provider/oidc_service.js';
+import { type DeletionResult } from '../account_deletion_service.js';
+import type { SettingsCapability } from '../runtime_settings.js';
 /** Quem disparou a operação (para auditoria). `admin-api` quando via REST API. */
 export interface AdminActor {
     actorId: string | null;
     ip: string | null;
     /** Marca metadata da auditoria — 'admin-api' nas escritas via REST, 'admin' no console HTML. */
-    source?: "admin-api" | "admin";
+    source?: 'admin-api' | 'admin';
 }
 /** Resultado da deleção via admin: false quando o store não suporta hard delete. */
 export type DeleteUserResult = {
     ok: false;
-    reason: "not_found" | "unsupported";
+    reason: 'not_found' | 'unsupported';
 } | {
     ok: true;
     result: DeletionResult;
@@ -34,7 +34,7 @@ export type EnqueueDeletion = (input: {
     actor: {
         actorId: string | null;
         ip: string | null;
-        source: "admin" | "admin-api";
+        source: 'admin' | 'admin-api';
     };
 }) => Promise<string>;
 export interface CreateUserInput {
@@ -50,10 +50,10 @@ export type CreateUserResult = {
     invited: boolean;
 } | {
     ok: false;
-    reason: "email_taken";
+    reason: 'email_taken';
 } | {
     ok: false;
-    reason: "password_policy";
+    reason: 'password_policy';
     /** Chave i18n da regra violada + params para interpolar. */
     messageKey: string;
     messageParams?: Record<string, string | number>;
@@ -141,7 +141,7 @@ export declare class AdminUsersService {
      *
      * @returns código i18n/erro quando a operação deve ser bloqueada; `null` quando OK.
      */
-    guardGlobalRolesChange(targetId: string, newRoles: string[], actorId: string | null): Promise<"last_admin" | "cannot_self_demote" | null>;
+    guardGlobalRolesChange(targetId: string, newRoles: string[], actorId: string | null): Promise<'last_admin' | 'cannot_self_demote' | null>;
     /** Atualiza nome/avatar (capacidade opcional). Retorna a conta ou null. */
     updateProfile(accountId: string, patch: {
         name?: string | null;

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

@@ -1,9 +1,9 @@
-import { randomBytes } from "node:crypto";
-import { supportsAccountDeletion, supportsAccountStatus, supportsProfile, supportsCountByGlobalRole, } from "../../accounts/account_store.js";
-import { sendPasswordResetEmail } from "../default_mailer.js";
-import { AccountDeletionService, } from "../account_deletion_service.js";
-import { PasswordPolicyError } from "../../password/password_manager.js";
-import { resolveEffectiveRolesCatalog } from "../runtime_toggles.js";
+import { randomBytes } from 'node:crypto';
+import { supportsAccountDeletion, supportsAccountStatus, supportsCountByGlobalRole, supportsProfile, } from '../../accounts/account_store.js';
+import { PasswordPolicyError } from '../../password/password_manager.js';
+import { AccountDeletionService } from '../account_deletion_service.js';
+import { sendPasswordResetEmail } from '../default_mailer.js';
+import { resolveEffectiveRolesCatalog } from '../runtime_toggles.js';
 /**
  * Lógica de gestão de usuários compartilhada entre o console admin (B6, HTML) e a
  * Admin REST API (R6, JSON). Encapsula o fluxo "create + invite", reset de senha,
@@ -24,9 +24,9 @@ export class AdminUsersService {
         const store = this.cfg.accountStore;
         const existing = await store.findByEmail(input.email);
         if (existing)
-            return { ok: false, reason: "email_taken" };
+            return { ok: false, reason: 'email_taken' };
         const hasPassword = !!input.password;
-        const initialPassword = input.password ?? randomBytes(24).toString("hex");
+        const initialPassword = input.password ?? randomBytes(24).toString('hex');
         let account;
         try {
             account = await store.create({
@@ -40,7 +40,7 @@ export class AdminUsersService {
             if (error instanceof PasswordPolicyError) {
                 return {
                     ok: false,
-                    reason: "password_policy",
+                    reason: 'password_policy',
                     messageKey: error.key,
                     messageParams: error.params,
                 };
@@ -48,7 +48,7 @@ export class AdminUsersService {
             throw error;
         }
         await this.cfg.audit?.record({
-            type: "user.created",
+            type: 'user.created',
             accountId: account.id,
             email: input.email,
             actorId: actor.actorId,
@@ -70,7 +70,7 @@ export class AdminUsersService {
             return null;
         await this.sendResetEmail(ctx, account.email);
         await this.cfg.audit?.record({
-            type: "user.password_reset_sent",
+            type: 'user.password_reset_sent',
             accountId,
             email: account.email,
             actorId: actor.actorId,
@@ -92,7 +92,7 @@ export class AdminUsersService {
         else
             await store.enableAccount(accountId);
         await this.cfg.audit?.record({
-            type: disable ? "user.disabled" : "user.enabled",
+            type: disable ? 'user.disabled' : 'user.enabled',
             accountId,
             actorId: actor.actorId,
             ip: actor.ip,
@@ -123,7 +123,7 @@ export class AdminUsersService {
             // Roles que o usuário não tinha E que não estão no catálogo = inválidas.
             for (const role of roles) {
                 if (!catalogNames.has(role) && !currentRoles.has(role)) {
-                    return "admin.roles.unknown_role";
+                    return 'admin.roles.unknown_role';
                 }
             }
         }
@@ -137,7 +137,7 @@ export class AdminUsersService {
     /** Roles globais que conferem acesso de admin (default ['ADMIN']). */
     adminRoles() {
         const roles = this.cfg.admin?.roles;
-        return roles && roles.length > 0 ? roles : ["ADMIN"];
+        return roles && roles.length > 0 ? roles : ['ADMIN'];
     }
     /** Um conjunto de roles contém ao menos uma role de admin? */
     hasAdminRole(roles) {
@@ -226,11 +226,11 @@ export class AdminUsersService {
             return null;
         // Auto-rebaixamento: o ator removendo a própria role de admin.
         if (actorId && actorId === targetId)
-            return "cannot_self_demote";
+            return 'cannot_self_demote';
         // Último admin: se o target é o único admin, a remoção causaria lockout.
         const admins = await this.countAdmins();
         if (admins <= 1)
-            return "last_admin";
+            return 'last_admin';
         return null;
     }
     /** Atualiza nome/avatar (capacidade opcional). Retorna a conta ou null. */
@@ -251,15 +251,15 @@ export class AdminUsersService {
     async delete(oidc, accountId, actor, enqueue) {
         const store = this.cfg.accountStore;
         if (!supportsAccountDeletion(store))
-            return { ok: false, reason: "unsupported" };
+            return { ok: false, reason: 'unsupported' };
         const account = await store.findById(accountId);
         if (!account)
-            return { ok: false, reason: "not_found" };
-        const source = actor.source === "admin" ? "admin" : "admin-api";
+            return { ok: false, reason: 'not_found' };
+        const source = actor.source === 'admin' ? 'admin' : 'admin-api';
         // Trilha administrativa ANTES do cascade — assim esta linha também é
         // anonimizada na etapa de anonimização do audit (não reintroduz PII).
         await this.cfg.audit?.record({
-            type: "user.deleted",
+            type: 'user.deleted',
             accountId,
             email: account.email,
             actorId: actor.actorId,

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

@@ -1,7 +1,7 @@
 import '../augmentations.js';
 import { AdminClientsService } from '../admin_clients_service.js';
-import { clientDto, createdClientDto, apiError } from './dto.js';
-import { clientInputValidator, clientCreateInput, clientPartialInput } from '../admin_validators.js';
+import { clientCreateInput, clientInputValidator, clientPartialInput, } from '../admin_validators.js';
+import { apiError, clientDto, createdClientDto } from './dto.js';
 /** Resolve o serviço (== OidcService) + o AdminClientsService. */
 async function clientsService(ctx) {
     const service = await ctx.containerResolver.make('authkit.server');

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

@@ -1,9 +1,9 @@
 import '../augmentations.js';
-import { TokenVerifyService } from './token_verify_service.js';
 import { AdminSessionsService } from '../admin_sessions_service.js';
 import { computeAdminStats } from '../admin_stats_service.js';
-import { auditDto, apiError } from './dto.js';
 import { tokenVerifyValidator } from '../admin_validators.js';
+import { apiError, auditDto } from './dto.js';
+import { TokenVerifyService } from './token_verify_service.js';
 /**
  * Endpoints utilitários da Admin REST API: log de auditoria (`GET /audit`) e
  * introspecção genérica de token (`POST /tokens/verify`).

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

@@ -1,8 +1,8 @@
 import '../augmentations.js';
-import { AdminOrgsService } from './admin_orgs_service.js';
-import { orgDto, orgDetailDto, orgInvitationDto, apiError } from './dto.js';
+import { orgAddMemberValidator, orgCreateValidator, orgInvitationValidator, orgMemberRoleValidator, orgUpdateValidator, } from '../admin_validators.js';
 import { resolveRuntimeSettings } from '../runtime_settings.js';
-import { orgCreateValidator, orgUpdateValidator, orgAddMemberValidator, orgMemberRoleValidator, orgInvitationValidator, } from '../admin_validators.js';
+import { AdminOrgsService } from './admin_orgs_service.js';
+import { apiError, orgDetailDto, orgDto, orgInvitationDto } from './dto.js';
 /** Lê a config + monta o actor `admin-api` para auditoria. */
 async function ctxBits(ctx) {
     const service = await ctx.containerResolver.make('authkit.server');

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

@@ -1,7 +1,7 @@
 import '../augmentations.js';
+import { SettingLockedError, isSettingLocked, lockedSettingKeys } from '../config_locks.js';
 import { resolveRuntimeSettings } from '../runtime_settings.js';
-import { settingDto, apiError } from './dto.js';
-import { isSettingLocked, lockedSettingKeys, SettingLockedError } from '../config_locks.js';
+import { apiError, settingDto } from './dto.js';
 /** 423 Locked: a setting foi travada via defineConfig (não editável em runtime). */
 function lockedResponse(ctx, err) {
     return ctx.response
@@ -16,8 +16,8 @@ function notSupported(ctx) {
 function resolveOrgId(ctx) {
     const qs = ctx.request.qs();
     if ('organizationId' in qs) {
-        const v = qs['organizationId'];
-        return v && v.trim() ? v.trim() : null;
+        const v = qs.organizationId;
+        return v?.trim() ? v.trim() : null;
     }
     return null;
 }
@@ -99,7 +99,13 @@ export default class ApiSettingsController {
             metadata: { key, value: body.value, organizationId: orgId },
         });
         const saved = await svc.getSetting(key, orgId);
-        return settingDto({ key, organizationId: orgId, value: saved, updatedAt: new Date(), updatedBy: null });
+        return settingDto({
+            key,
+            organizationId: orgId,
+            value: saved,
+            updatedAt: new Date(),
+            updatedBy: null,
+        });
     }
     /** DELETE /settings/:key */
     async destroy(ctx) {

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

@@ -1,5 +1,5 @@
-import "../augmentations.js";
-import type { HttpContext } from "@adonisjs/core/http";
+import '../augmentations.js';
+import type { HttpContext } from '@adonisjs/core/http';
 /**
  * Recurso de usuários da Admin REST API (R6). JSON puro (camelCase), erros no
  * envelope `{ error: { code, message } }`. Toda escrita audita com `actor: 'admin-api'`.