@thunderid/express 1.3.1 → 1.5.0

package/dist/ThunderIDExpressClient.d.ts

@@ -1,4 +1,4 @@
-import { ThunderIDNodeClient, Storage, TokenResponse, User } from '@thunderid/node';
+import { ThunderIDNodeClient, ThunderIDNodeManagementClient, Storage, TokenResponse, User } from '@thunderid/node';
 import express from 'express';
 import { ExpressClientConfig } from './models/config';
 declare class ThunderIDExpressClient<T extends ExpressClientConfig = ExpressClientConfig> extends ThunderIDNodeClient<T> {
@@ -13,6 +13,21 @@ declare class ThunderIDExpressClient<T extends ExpressClientConfig = ExpressClie
      */
     getSessionCookieName(): string;
     getUserFromRequest(req: express.Request): Promise<User | undefined>;
+    /**
+     * Returns the management operations bound to the session named by the request's session cookie,
+     * so a route handler can administer users, groups, roles, and agents as the signed-in user. The
+     * session's access token stays on the server and is read on every call.
+     *
+     * ```ts
+     * app.get('/admin/users', protect(), async (req, res) => {
+     *   const admin = req.thunderIDAuth.managementFromRequest(req);
+     *   res.json(await admin.users.list({limit: 20}));
+     * });
+     * ```
+     *
+     * @throws {ThunderIDRuntimeError} `EXPRESS-CLIENT-MFR-NF01` when the request carries no session cookie.
+     */
+    managementFromRequest(req: express.Request): ThunderIDNodeManagementClient;
     updateUserCredentialsFromRequest(req: express.Request, payload: Record<string, string>): Promise<void>;
     signIn(req: express.Request, res: express.Response, next?: express.NextFunction, signInConfig?: Record<string, string | boolean>): Promise<TokenResponse>;
     signOut(userId?: string): Promise<string>;

package/dist/ThunderIDExpressClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThunderIDExpressClient.d.ts","sourceRoot":"","sources":["../src/ThunderIDExpressClient.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EAEnB,OAAO,EACP,aAAa,EACb,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAC,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAGpD,cAAM,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9G,OAAO,CAAC,cAAc,CAAkC;;IAMlC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhF,IAAW,aAAa,IAAI,mBAAmB,GAAG,SAAS,CAE1D;IAED;;;;OAIG;IACI,oBAAoB,IAAI,MAAM;IAOxB,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAMnE,gCAAgC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7F,MAAM,CAC1B,GAAG,EAAE,OAAO,CAAC,OAAO,EACpB,GAAG,EAAE,OAAO,CAAC,QAAQ,EACrB,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,EAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAC9C,OAAO,CAAC,aAAa,CAAC;IAuDH,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhE;AAED,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"ThunderIDExpressClient.d.ts","sourceRoot":"","sources":["../src/ThunderIDExpressClient.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EAEnB,6BAA6B,EAE7B,OAAO,EACP,aAAa,EACb,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAC,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAGpD,cAAM,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9G,OAAO,CAAC,cAAc,CAAkC;;IAMlC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhF,IAAW,aAAa,IAAI,mBAAmB,GAAG,SAAS,CAE1D;IAED;;;;OAIG;IACI,oBAAoB,IAAI,MAAM;IAOxB,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAMhF;;;;;;;;;;;;;OAaG;IACI,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,6BAA6B;IAWpE,gCAAgC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7F,MAAM,CAC1B,GAAG,EAAE,OAAO,CAAC,OAAO,EACpB,GAAG,EAAE,OAAO,CAAC,QAAQ,EACrB,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,EAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAC9C,OAAO,CAAC,aAAa,CAAC;IAuDH,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhE;AAED,eAAe,sBAAsB,CAAC"}

package/dist/cjs/index.cjs

@@ -75,6 +75,25 @@ var ThunderIDExpressClient = class extends __thunderid_node.ThunderIDNodeClient
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.getUser(sessionId);
 	}
+	/**
+	* Returns the management operations bound to the session named by the request's session cookie,
+	* so a route handler can administer users, groups, roles, and agents as the signed-in user. The
+	* session's access token stays on the server and is read on every call.
+	*
+	* ```ts
+	* app.get('/admin/users', protect(), async (req, res) => {
+	*   const admin = req.thunderIDAuth.managementFromRequest(req);
+	*   res.json(await admin.users.list({limit: 20}));
+	* });
+	* ```
+	*
+	* @throws {ThunderIDRuntimeError} `EXPRESS-CLIENT-MFR-NF01` when the request carries no session cookie.
+	*/
+	managementFromRequest(req) {
+		const sessionId = req.cookies?.[this.getSessionCookieName()];
+		if (!sessionId) throw new __thunderid_node.ThunderIDRuntimeError("No session cookie found in the request.", "EXPRESS-CLIENT-MFR-NF01", "express");
+		return this.management(sessionId);
+	}
 	async updateUserCredentialsFromRequest(req, payload) {
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.updateUserCredentials(payload, sessionId);

package/dist/edge/index.js

@@ -51,6 +51,25 @@ var ThunderIDExpressClient = class extends ThunderIDNodeClient {
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.getUser(sessionId);
 	}
+	/**
+	* Returns the management operations bound to the session named by the request's session cookie,
+	* so a route handler can administer users, groups, roles, and agents as the signed-in user. The
+	* session's access token stays on the server and is read on every call.
+	*
+	* ```ts
+	* app.get('/admin/users', protect(), async (req, res) => {
+	*   const admin = req.thunderIDAuth.managementFromRequest(req);
+	*   res.json(await admin.users.list({limit: 20}));
+	* });
+	* ```
+	*
+	* @throws {ThunderIDRuntimeError} `EXPRESS-CLIENT-MFR-NF01` when the request carries no session cookie.
+	*/
+	managementFromRequest(req) {
+		const sessionId = req.cookies?.[this.getSessionCookieName()];
+		if (!sessionId) throw new ThunderIDRuntimeError("No session cookie found in the request.", "EXPRESS-CLIENT-MFR-NF01", "express");
+		return this.management(sessionId);
+	}
 	async updateUserCredentialsFromRequest(req, payload) {
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.updateUserCredentials(payload, sessionId);

package/dist/index.js

@@ -51,6 +51,25 @@ var ThunderIDExpressClient = class extends ThunderIDNodeClient {
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.getUser(sessionId);
 	}
+	/**
+	* Returns the management operations bound to the session named by the request's session cookie,
+	* so a route handler can administer users, groups, roles, and agents as the signed-in user. The
+	* session's access token stays on the server and is read on every call.
+	*
+	* ```ts
+	* app.get('/admin/users', protect(), async (req, res) => {
+	*   const admin = req.thunderIDAuth.managementFromRequest(req);
+	*   res.json(await admin.users.list({limit: 20}));
+	* });
+	* ```
+	*
+	* @throws {ThunderIDRuntimeError} `EXPRESS-CLIENT-MFR-NF01` when the request carries no session cookie.
+	*/
+	managementFromRequest(req) {
+		const sessionId = req.cookies?.[this.getSessionCookieName()];
+		if (!sessionId) throw new ThunderIDRuntimeError("No session cookie found in the request.", "EXPRESS-CLIENT-MFR-NF01", "express");
+		return this.management(sessionId);
+	}
 	async updateUserCredentialsFromRequest(req, payload) {
 		const sessionId = req.cookies?.[this.getSessionCookieName()];
 		return this.updateUserCredentials(payload, sessionId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thunderid/express",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "Express.js SDK for ThunderID",
   "keywords": [
     "thunderid",
@@ -47,7 +47,7 @@
     "vitest": "4.1.11"
   },
   "dependencies": {
-    "@thunderid/node": "^1.3.1",
+    "@thunderid/node": "^1.5.0",
     "uuid": "11.1.1"
   },
   "peerDependencies": {