@adonis-agora/authkit-server 0.65.2 → 0.66.0

package/build/src/host/ui-dist/index.html

@@ -8,7 +8,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;500;600;700&family=JetBrains+Mono:ital,wght@0,400;0,500;0,600;1,400&display=swap" rel="stylesheet">
-    <script type="module" crossorigin src="/__AUTHKIT_BASE__/assets/index-Dp__4wlB.js"></script>
+    <script type="module" crossorigin src="/__AUTHKIT_BASE__/assets/index-CkCQ94la.js"></script>
     <link rel="stylesheet" crossorigin href="/__AUTHKIT_BASE__/assets/index-DTSmD4RU.css">
   </head>
   <body>

package/build/src/pagination.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Convenções de paginação por OFFSET compartilhadas por TODAS as listagens
+ * paginadas do authkit (contas, log de auditoria, console admin e Admin API).
+ *
+ * O shape `{ page, size }` espelha INTENCIONALMENTE o de `@adonis-agora/filter`
+ * (`FilterInput.page` / `FilterInput.size` → `ResolvedPagination { page, size }`),
+ * para que todos os pacotes `@adonis-agora/*` exponham a MESMA interface de
+ * paginação. O casamento é ESTRUTURAL de propósito: NÃO dependemos de
+ * `@adonis-agora/filter` — só seguimos o mesmo contrato.
+ *
+ * - `page` é 1-based; default {@link LIST_FIRST_PAGE}.
+ * - `size` é o tamanho da página; default {@link ADMIN_LIST_DEFAULT_SIZE} nas
+ *   varreduras programáticas e {@link ADMIN_LIST_HTTP_DEFAULT_SIZE} na wire HTTP.
+ * - Na wire HTTP os parâmetros são `?page=1&size=25`.
+ */
+/** Primeira página. A paginação é 1-based, como em `@adonis-agora/filter`. */
+export declare const LIST_FIRST_PAGE = 1;
+/**
+ * Tamanho de página default das varreduras programáticas internas (ex.: contagem
+ * de admins e agregação de orgs, que paginam o `accountStore` até o fim).
+ */
+export declare const ADMIN_LIST_DEFAULT_SIZE = 100;
+/**
+ * Tamanho de página default quando a request HTTP não manda `?size=`. Menor que
+ * {@link ADMIN_LIST_DEFAULT_SIZE} porque é o que a UI do console renderiza por página.
+ */
+export declare const ADMIN_LIST_HTTP_DEFAULT_SIZE = 20;
+/**
+ * Teto de `size` aceito de um caller NÃO CONFIÁVEL — ou seja, de query params
+ * HTTP ({@link parseListSize}). Antes não havia teto nenhum no console admin
+ * nem na Admin API além de um `Math.min` solto por controller; agora é um só
+ * número, para que um `?size=100000` não vire um scan de tabela inteira.
+ *
+ * NÃO é aplicado a chamadas programáticas de dentro da lib (ex.: o export
+ * LGPD/GDPR lê 1000 eventos de auditoria de uma vez): essas são confiáveis e
+ * usam {@link normalizeListSize}.
+ */
+export declare const ADMIN_LIST_MAX_SIZE = 200;
+/** Normaliza um `page` arbitrário para um inteiro 1-based válido. */
+export declare function resolveListPage(page: number | undefined): number;
+/**
+ * Normaliza um `size` de caller CONFIÁVEL para um inteiro `>= 1`, caindo em
+ * `fallback` quando ausente/inválido. Sem teto — veja {@link clampListSize}.
+ */
+export declare function normalizeListSize(size: number | undefined, fallback?: number): number;
+/**
+ * Idem {@link normalizeListSize}, mas limitado a {@link ADMIN_LIST_MAX_SIZE}.
+ * Use em TODA borda que recebe `size` de fora do processo.
+ */
+export declare function clampListSize(size: number | undefined, fallback?: number): number;
+/** {@link resolveListPage} a partir do valor cru de um query param. */
+export declare function parseListPage(raw: unknown): number;
+/** {@link clampListSize} a partir do valor cru de um query param. */
+export declare function parseListSize(raw: unknown, fallback?: number): number;
+/**
+ * Envelope de METADADOS de uma listagem paginada — a chave `meta` de toda
+ * resposta paginada do authkit (`{ meta, data }`).
+ *
+ * O nome `meta` e a co-locação de `{ page, size }` dentro dele são a convenção
+ * do `.paginate()` do Lucid (`{ meta, data }`) — que é onde o caminho por
+ * offset de `@adonis-agora/filter` desemboca — e por isso a convenção adotada
+ * por TODO o ecossistema `@adonis-agora/*`. Antes o authkit achatava
+ * `total`/`page`/`size` ao lado de `data`, sem envelope.
+ */
+export interface ListMeta {
+    /** Página devolvida (1-based). */
+    page: number;
+    /** Tamanho de página efetivamente aplicado (já normalizado/limitado). */
+    size: number;
+    /** Total absoluto de itens que casam com o filtro, através de todas as páginas. */
+    total: number;
+}
+/** Resposta paginada padrão: `{ meta, data }`, na ordem do `.paginate()` do Lucid. */
+export interface PaginatedResponse<T> {
+    meta: ListMeta;
+    data: T[];
+}

package/build/src/pagination.js

@@ -0,0 +1,66 @@
+/**
+ * Convenções de paginação por OFFSET compartilhadas por TODAS as listagens
+ * paginadas do authkit (contas, log de auditoria, console admin e Admin API).
+ *
+ * O shape `{ page, size }` espelha INTENCIONALMENTE o de `@adonis-agora/filter`
+ * (`FilterInput.page` / `FilterInput.size` → `ResolvedPagination { page, size }`),
+ * para que todos os pacotes `@adonis-agora/*` exponham a MESMA interface de
+ * paginação. O casamento é ESTRUTURAL de propósito: NÃO dependemos de
+ * `@adonis-agora/filter` — só seguimos o mesmo contrato.
+ *
+ * - `page` é 1-based; default {@link LIST_FIRST_PAGE}.
+ * - `size` é o tamanho da página; default {@link ADMIN_LIST_DEFAULT_SIZE} nas
+ *   varreduras programáticas e {@link ADMIN_LIST_HTTP_DEFAULT_SIZE} na wire HTTP.
+ * - Na wire HTTP os parâmetros são `?page=1&size=25`.
+ */
+/** Primeira página. A paginação é 1-based, como em `@adonis-agora/filter`. */
+export const LIST_FIRST_PAGE = 1;
+/**
+ * Tamanho de página default das varreduras programáticas internas (ex.: contagem
+ * de admins e agregação de orgs, que paginam o `accountStore` até o fim).
+ */
+export const ADMIN_LIST_DEFAULT_SIZE = 100;
+/**
+ * Tamanho de página default quando a request HTTP não manda `?size=`. Menor que
+ * {@link ADMIN_LIST_DEFAULT_SIZE} porque é o que a UI do console renderiza por página.
+ */
+export const ADMIN_LIST_HTTP_DEFAULT_SIZE = 20;
+/**
+ * Teto de `size` aceito de um caller NÃO CONFIÁVEL — ou seja, de query params
+ * HTTP ({@link parseListSize}). Antes não havia teto nenhum no console admin
+ * nem na Admin API além de um `Math.min` solto por controller; agora é um só
+ * número, para que um `?size=100000` não vire um scan de tabela inteira.
+ *
+ * NÃO é aplicado a chamadas programáticas de dentro da lib (ex.: o export
+ * LGPD/GDPR lê 1000 eventos de auditoria de uma vez): essas são confiáveis e
+ * usam {@link normalizeListSize}.
+ */
+export const ADMIN_LIST_MAX_SIZE = 200;
+/** Normaliza um `page` arbitrário para um inteiro 1-based válido. */
+export function resolveListPage(page) {
+    const n = Math.trunc(Number(page));
+    return Number.isFinite(n) && n >= LIST_FIRST_PAGE ? n : LIST_FIRST_PAGE;
+}
+/**
+ * Normaliza um `size` de caller CONFIÁVEL para um inteiro `>= 1`, caindo em
+ * `fallback` quando ausente/inválido. Sem teto — veja {@link clampListSize}.
+ */
+export function normalizeListSize(size, fallback = ADMIN_LIST_DEFAULT_SIZE) {
+    const n = Math.trunc(Number(size));
+    return Number.isFinite(n) && n >= 1 ? n : Math.max(1, fallback);
+}
+/**
+ * Idem {@link normalizeListSize}, mas limitado a {@link ADMIN_LIST_MAX_SIZE}.
+ * Use em TODA borda que recebe `size` de fora do processo.
+ */
+export function clampListSize(size, fallback = ADMIN_LIST_DEFAULT_SIZE) {
+    return Math.min(ADMIN_LIST_MAX_SIZE, normalizeListSize(size, fallback));
+}
+/** {@link resolveListPage} a partir do valor cru de um query param. */
+export function parseListPage(raw) {
+    return resolveListPage(Number.parseInt(String(raw ?? ''), 10));
+}
+/** {@link clampListSize} a partir do valor cru de um query param. */
+export function parseListSize(raw, fallback = ADMIN_LIST_HTTP_DEFAULT_SIZE) {
+    return clampListSize(Number.parseInt(String(raw ?? ''), 10), fallback);
+}

package/build/stubs/migrations/create_auth_users_table.stub

@@ -0,0 +1,47 @@
+{{{
+  exports({
+    to: app.makePath(migration.folder, entity.path, migration.fileName)
+  })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+export default class extends BaseSchema {
+  protected tableName = 'auth_users'
+
+  async up() {
+    this.schema.createTable(this.tableName, (table) => {
+      /**
+       * String, NÃO increments(): o hook `@beforeCreate` do model scaffoldado
+       * (`models/auth_user.stub`) atribui um `randomUUID()` antes do insert.
+       * Uma coluna auto-increment aceitaria o INSERT mesmo assim, mas o valor
+       * do UUID seria descartado e o `id` do model voltaria como o rowid
+       * interno do banco — a conta ficaria inalcançável pelo id real na
+       * próxima request. Ver packages/authkit-server/stubs/models/auth_user.stub.
+       */
+      table.string('id').notNullable().primary()
+
+      // withAuthUser() — packages/authkit-server/src/mixins/with_auth_user.ts
+      table.string('email').notNullable().unique()
+      table.string('password').notNullable()
+      // Serializado como JSON string ("[]" quando vazio) pelo mixin.
+      table.json('global_roles').notNullable().defaultTo('[]')
+
+      // withCredentials() — packages/authkit-server/src/mixins/with_credentials.ts
+      table.timestamp('email_verified_at', { useTz: true }).nullable()
+      table.string('email_verification_token').nullable()
+      table.string('password_reset_token').nullable()
+      table.timestamp('password_reset_expires_at', { useTz: true }).nullable()
+
+      // Coluna própria do model scaffoldado (não vem de nenhum mixin): a tela
+      // de signup embutida sempre coleta "Nome" e o Lucid store passa esse
+      // valor direto para `AuthUser.create()` — sem esta coluna o primeiro
+      // signup quebra com "Cannot define 'fullName' on 'AuthUser' model,
+      // since it is not defined as a model property".
+      table.string('full_name').nullable()
+    })
+  }
+
+  async down() {
+    this.schema.dropTable(this.tableName)
+  }
+}

package/build/stubs/models/auth_user.stub

@@ -1,7 +1,8 @@
 {{{
   exports({ to: app.makePath('app/models/auth_user.ts') })
 }}}
-import { BaseModel, column } from '@adonisjs/lucid/orm'
+import { randomUUID } from 'node:crypto'
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm'
 import { compose } from '@adonisjs/core/helpers'
 import { withAuthUser, withCredentials } from '@adonis-agora/authkit-server'
 
@@ -17,6 +18,34 @@ import { withAuthUser, withCredentials } from '@adonis-agora/authkit-server'
  * (e aponte as migrations correspondentes para essa conexão).
  */
 export default class AuthUser extends compose(BaseModel, withAuthUser(), withCredentials()) {
+  /**
+   * Sem isto, o Lucid ignora o id atribuído pelo hook abaixo e sobrescreve
+   * `id` com o retorno bruto do INSERT (o rowid interno do SQLite/Postgres)
+   * assim que a linha é salva — mesmo resultado prático de não ter o hook: a
+   * conta some do próprio id que acabou de criar.
+   */
+  static selfAssignPrimaryKey = true
+
   @column({ isPrimary: true })
   declare id: string
+
+  /**
+   * Nem withAuthUser() nem withCredentials() geram o id — sem este hook o
+   * Lucid insere NULL nesta coluna string e o `id` do model volta como o
+   * rowid interno do banco, tornando a conta inalcançável pelo id real na
+   * próxima request.
+   */
+  @beforeCreate()
+  static assignUuid(user: AuthUser) {
+    user.id = randomUUID()
+  }
+
+  /**
+   * A tela de signup embutida sempre coleta um campo "Nome", e o Lucid store
+   * passa esse valor direto para `AuthUser.create()` — sem esta coluna o
+   * primeiro signup quebra com "Cannot define 'fullName' on 'AuthUser'
+   * model, since it is not defined as a model property".
+   */
+  @column()
+  declare fullName: string | null
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/authkit-server",
-  "version": "0.65.2",
+  "version": "0.66.0",
   "description": "AdonisJS OIDC/OAuth2 provider (Identity Provider) toolkit: ejectable auth server with sessions, rate-limiting, MFA/TOTP, audit log, federated logout and OpenTelemetry metrics.",
   "license": "MIT",
   "author": "dudousxd",
@@ -103,19 +103,19 @@
   },
   "dependencies": {
     "@adonis-agora/authkit-core": "0.8.0",
-    "@simplewebauthn/browser": "13.3.0",
-    "@simplewebauthn/server": "13.3.3",
-    "jose": "6.2.10",
+    "@simplewebauthn/browser": "14.0.0",
+    "@simplewebauthn/server": "14.0.1",
+    "jose": "6.2.12",
     "koa": "3.2.1",
     "koa-mount": "4.2.0",
-    "oidc-provider": "9.12.0",
+    "oidc-provider": "9.12.2",
     "otplib": "13.5.0",
     "qrcode": "1.5.4"
   },
   "devDependencies": {
-    "@adonis-agora/authkit-react": "0.20.1",
-    "@adonis-agora/durable": "0.26.0",
-    "@adonis-agora/telescope": "0.9.1",
+    "@adonis-agora/authkit-react": "0.21.0",
+    "@adonis-agora/durable": "0.38.3",
+    "@adonis-agora/telescope": "0.20.0",
     "@adonisjs/ally": "6.3.0",
     "@adonisjs/auth": "10.1.0",
     "@adonisjs/core": "7.5.0",
@@ -128,17 +128,17 @@
     "@japa/assert": "4.2.0",
     "@japa/runner": "5.3.0",
     "@poppinss/ts-exec": "1.4.4",
-    "@tanstack/intent": "^0.3.8",
+    "@tanstack/intent": "^0.4.0",
     "@tanstack/react-query": "5.102.8",
     "@types/better-sqlite3": "9.6.0",
     "@types/ioredis-mock": "8.2.8",
     "@types/koa": "3.0.3",
     "@types/koa-mount": "4.0.5",
     "@types/luxon": "3.7.5",
-    "@types/node": "26.4.0",
+    "@types/node": "26.5.0",
     "@types/qrcode": "1.5.6",
     "@types/react": "19.2.18",
-    "@types/react-dom": "19.2.5",
+    "@types/react-dom": "19.2.7",
     "@vinejs/vine": "4.4.0",
     "@vitejs/plugin-react": "6.1.1",
     "better-sqlite3": "13.0.3",
@@ -150,7 +150,7 @@
     "nuqs": "2.10.1",
     "react": "19.2.8",
     "react-dom": "19.2.8",
-    "react-error-boundary": "6.1.4",
+    "react-error-boundary": "6.1.5",
     "recharts": "3.10.1",
     "tailwindcss": "3.4.19",
     "typescript": "7.0.2",

package/stubs/migrations/create_auth_users_table.stub

@@ -0,0 +1,47 @@
+{{{
+  exports({
+    to: app.makePath(migration.folder, entity.path, migration.fileName)
+  })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+export default class extends BaseSchema {
+  protected tableName = 'auth_users'
+
+  async up() {
+    this.schema.createTable(this.tableName, (table) => {
+      /**
+       * String, NÃO increments(): o hook `@beforeCreate` do model scaffoldado
+       * (`models/auth_user.stub`) atribui um `randomUUID()` antes do insert.
+       * Uma coluna auto-increment aceitaria o INSERT mesmo assim, mas o valor
+       * do UUID seria descartado e o `id` do model voltaria como o rowid
+       * interno do banco — a conta ficaria inalcançável pelo id real na
+       * próxima request. Ver packages/authkit-server/stubs/models/auth_user.stub.
+       */
+      table.string('id').notNullable().primary()
+
+      // withAuthUser() — packages/authkit-server/src/mixins/with_auth_user.ts
+      table.string('email').notNullable().unique()
+      table.string('password').notNullable()
+      // Serializado como JSON string ("[]" quando vazio) pelo mixin.
+      table.json('global_roles').notNullable().defaultTo('[]')
+
+      // withCredentials() — packages/authkit-server/src/mixins/with_credentials.ts
+      table.timestamp('email_verified_at', { useTz: true }).nullable()
+      table.string('email_verification_token').nullable()
+      table.string('password_reset_token').nullable()
+      table.timestamp('password_reset_expires_at', { useTz: true }).nullable()
+
+      // Coluna própria do model scaffoldado (não vem de nenhum mixin): a tela
+      // de signup embutida sempre coleta "Nome" e o Lucid store passa esse
+      // valor direto para `AuthUser.create()` — sem esta coluna o primeiro
+      // signup quebra com "Cannot define 'fullName' on 'AuthUser' model,
+      // since it is not defined as a model property".
+      table.string('full_name').nullable()
+    })
+  }
+
+  async down() {
+    this.schema.dropTable(this.tableName)
+  }
+}

package/stubs/models/auth_user.stub

@@ -1,7 +1,8 @@
 {{{
   exports({ to: app.makePath('app/models/auth_user.ts') })
 }}}
-import { BaseModel, column } from '@adonisjs/lucid/orm'
+import { randomUUID } from 'node:crypto'
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm'
 import { compose } from '@adonisjs/core/helpers'
 import { withAuthUser, withCredentials } from '@adonis-agora/authkit-server'
 
@@ -17,6 +18,34 @@ import { withAuthUser, withCredentials } from '@adonis-agora/authkit-server'
  * (e aponte as migrations correspondentes para essa conexão).
  */
 export default class AuthUser extends compose(BaseModel, withAuthUser(), withCredentials()) {
+  /**
+   * Sem isto, o Lucid ignora o id atribuído pelo hook abaixo e sobrescreve
+   * `id` com o retorno bruto do INSERT (o rowid interno do SQLite/Postgres)
+   * assim que a linha é salva — mesmo resultado prático de não ter o hook: a
+   * conta some do próprio id que acabou de criar.
+   */
+  static selfAssignPrimaryKey = true
+
   @column({ isPrimary: true })
   declare id: string
+
+  /**
+   * Nem withAuthUser() nem withCredentials() geram o id — sem este hook o
+   * Lucid insere NULL nesta coluna string e o `id` do model volta como o
+   * rowid interno do banco, tornando a conta inalcançável pelo id real na
+   * próxima request.
+   */
+  @beforeCreate()
+  static assignUuid(user: AuthUser) {
+    user.id = randomUUID()
+  }
+
+  /**
+   * A tela de signup embutida sempre coleta um campo "Nome", e o Lucid store
+   * passa esse valor direto para `AuthUser.create()` — sem esta coluna o
+   * primeiro signup quebra com "Cannot define 'fullName' on 'AuthUser'
+   * model, since it is not defined as a model property".
+   */
+  @column()
+  declare fullName: string | null
 }