@adonis-agora/authkit-client 0.12.0 → 0.14.0

package/build/services/main.d.ts

@@ -0,0 +1,10 @@
+import type { AuthkitClientManager } from "../providers/authkit_client_provider.js";
+/**
+ * Singleton accessor for the {@link AuthkitClientManager}, following the Adonis `services/main`
+ * convention (like `db`, `mail`, `drive`). Lets an app write
+ * `import authkit from "@adonis-agora/authkit-client/services/main"` and read `authkit.clientConfig`
+ * / call `authkit.getIdToken(ctx)` etc., instead of resolving the string-keyed `"authkit.client"`
+ * binding through the container by hand.
+ */
+declare let manager: AuthkitClientManager;
+export { manager as default };

package/build/services/main.js

@@ -0,0 +1,13 @@
+import app from "@adonisjs/core/services/app";
+/**
+ * Singleton accessor for the {@link AuthkitClientManager}, following the Adonis `services/main`
+ * convention (like `db`, `mail`, `drive`). Lets an app write
+ * `import authkit from "@adonis-agora/authkit-client/services/main"` and read `authkit.clientConfig`
+ * / call `authkit.getIdToken(ctx)` etc., instead of resolving the string-keyed `"authkit.client"`
+ * binding through the container by hand.
+ */
+let manager;
+await app.booted(async () => {
+    manager = await app.container.make("authkit.client");
+});
+export { manager as default };

package/build/src/authenticator.d.ts

@@ -28,6 +28,14 @@ export declare class Authenticator<TUser = unknown> {
     check(): Promise<boolean>;
     hasGlobalRole(role: string): boolean;
     getUser(): Promise<TUser | null>;
+    /**
+     * O `TUser` autenticado, NÃO-nulo. Fail-closed: lança quando não há sessão (ou quando `resolveUser`
+     * não devolve usuário) — pensado para rotas atrás do middleware de auth, onde `null` seria uma
+     * rota mal-configurada, não um visitante. Espelha `authenticate()` (que devolve a `Identity`); este
+     * devolve o usuário do app. Substitui o wrapper `currentUser(auth)` que cada app reescrevia sobre
+     * `getUser()`. Para rotas que aceitam visitante, use `getUser()` (devolve `TUser | null`).
+     */
+    getUserOrFail(): Promise<TUser>;
     /**
      * Monta o objeto pronto para compartilhar com o frontend (ex.: Inertia share),
      * casando com o `AuthSharedProps` que o `@adonis-agora/authkit-react` consome.

package/build/src/authenticator.js

@@ -1,4 +1,4 @@
-import { AUTHKIT_METRICS, NoopRecorder } from "@adonis-agora/authkit-core";
+import { AUTHKIT_METRICS, NoopRecorder, } from "@adonis-agora/authkit-core";
 import { populateContext } from "./observability/context_bridge.js";
 /**
  * Autenticador do request. O parâmetro `TUser` é o tipo do usuário do app que `resolveUser`
@@ -64,7 +64,9 @@ export class Authenticator {
             const accessToken = this.deps.getAccessToken?.() ?? undefined;
             // `resolveUser` é tipado `Promise<unknown>` (a lib não conhece o model do app); o `TUser`
             // é a asserção do consumidor, feita UMA vez aqui em vez de em cada call-site de `getUser()`.
-            this.#user = (await this.deps.resolveUser(identity, { accessToken }));
+            this.#user = (await this.deps.resolveUser(identity, {
+                accessToken,
+            }));
         }
         else {
             this.#user = null;
@@ -72,6 +74,20 @@ export class Authenticator {
         this.#userResolved = true;
         return this.#user;
     }
+    /**
+     * O `TUser` autenticado, NÃO-nulo. Fail-closed: lança quando não há sessão (ou quando `resolveUser`
+     * não devolve usuário) — pensado para rotas atrás do middleware de auth, onde `null` seria uma
+     * rota mal-configurada, não um visitante. Espelha `authenticate()` (que devolve a `Identity`); este
+     * devolve o usuário do app. Substitui o wrapper `currentUser(auth)` que cada app reescrevia sobre
+     * `getUser()`. Para rotas que aceitam visitante, use `getUser()` (devolve `TUser | null`).
+     */
+    async getUserOrFail() {
+        const user = await this.getUser();
+        if (user === null) {
+            throw new Error("Not authenticated: no user for the current session");
+        }
+        return user;
+    }
     /**
      * Monta o objeto pronto para compartilhar com o frontend (ex.: Inertia share),
      * casando com o `AuthSharedProps` que o `@adonis-agora/authkit-react` consome.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/authkit-client",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "AdonisJS OIDC/OAuth2 relying-party (client) toolkit: session-based authentication against an OpenID Connect identity provider, with JWT/PAT user resolvers and OpenTelemetry metrics.",
   "license": "MIT",
   "author": "dudousxd",
@@ -36,6 +36,7 @@
   "exports": {
     ".": "./build/index.js",
     "./types": "./build/index.js",
+    "./services/main": "./build/services/main.js",
     "./authkit_client_provider": "./build/providers/authkit_client_provider.js",
     "./authkit_middleware": "./build/src/middleware/authkit_middleware.js",
     "./backchannel_revocation_middleware": "./build/src/middleware/backchannel_revocation_middleware.js",