@authgate/browser 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -80,4 +80,33 @@ export declare function authFetch(input: RequestInfo | URL, init?: RequestInit,
  *          any reason (unauthorized, expired session, or error).
  */
 export declare function refreshSession(audience?: string): Promise<boolean>;
+export type CurrentUser = {
+    id: string;
+    email: string;
+    username: string;
+    /** Whether the user account is disabled */
+    disabled: boolean;
+    /** Account creation time (ISO 8601) */
+    created_at: string;
+};
+/**
+ * Fetches the currently authenticated user's identity.
+ *
+ * Behavior:
+ * - Calls GET /auth/user using credentials (cookies)
+ * - If the access token is expired, authFetch attempts a single refresh
+ * - If refresh succeeds, the request is retried once
+ * - If the user is not authenticated, returns null
+ *
+ * This function never throws for authentication failures.
+ *
+ * @param opts Optional options.
+ * @param opts.audience The audience for which authentication should be ensured
+ *        (e.g. "app", "admin"). Defaults to "app".
+ *
+ * @returns The current user object if authenticated, or `null` otherwise.
+ */
+export declare function getCurrentUser(opts?: {
+    audience?: string;
+}): Promise<CurrentUser | null>;
 export {};

package/dist/index.js

@@ -144,3 +144,41 @@ export async function refreshSession(audience = "app") {
     }
     return res.ok;
 }
+/**
+ * Fetches the currently authenticated user's identity.
+ *
+ * Behavior:
+ * - Calls GET /auth/user using credentials (cookies)
+ * - If the access token is expired, authFetch attempts a single refresh
+ * - If refresh succeeds, the request is retried once
+ * - If the user is not authenticated, returns null
+ *
+ * This function never throws for authentication failures.
+ *
+ * @param opts Optional options.
+ * @param opts.audience The audience for which authentication should be ensured
+ *        (e.g. "app", "admin"). Defaults to "app".
+ *
+ * @returns The current user object if authenticated, or `null` otherwise.
+ */
+export async function getCurrentUser(opts) {
+    let res;
+    try {
+        res = await authFetch("/auth/user", { method: "GET" }, { audience: opts?.audience ?? "app" });
+    }
+    catch {
+        return null;
+    }
+    if (res.status === 401) {
+        return null;
+    }
+    if (!res.ok) {
+        return null;
+    }
+    try {
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/alexlup06-authgate/authgate-browser.git"
   },
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Browser-side helpers for AuthGate (logout, CSRF forwarding)",
   "license": "MIT",
   "type": "module",