@oauth2-cli/qui-cli 0.7.6 → 0.7.9

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.7.9](https://github.com/battis/oauth2-cli/compare/qui-cli-plugin/0.7.8...qui-cli-plugin/0.7.9) (2026-02-19)
+
+## [0.7.8](https://github.com/battis/oauth2-cli/compare/qui-cli-plugin/0.7.7...qui-cli-plugin/0.7.8) (2026-02-19)
+
+## [0.7.7](https://github.com/battis/oauth2-cli/compare/qui-cli-plugin/0.7.6...qui-cli-plugin/0.7.7) (2026-02-19)
+
+
+### Features
+
+* human-readable client name for clarity ([68b4287](https://github.com/battis/oauth2-cli/commit/68b42872998ec423440d07447012282528e3ee76))
+
 ## [0.7.6](https://github.com/battis/oauth2-cli/compare/qui-cli-plugin/0.7.5...qui-cli-plugin/0.7.6) (2026-02-19)
 
 

package/dist/Client.js

@@ -5,7 +5,7 @@ export class Client extends OAuth2CLI.Client {
         const creating = !this.config;
         const config = await super.getConfiguration();
         if (creating) {
-            Log.debug('OAuth 2.0 configuration created', {
+            Log.debug(`${this.clientName()} OAuth 2.0 configuration created`, {
                 credentials: this.credentials,
                 config: {
                     serverMetadata: config.serverMetadata(),
@@ -16,22 +16,26 @@ export class Client extends OAuth2CLI.Client {
         return config;
     }
     async authorize() {
-        Log.debug('Authorizing new access token');
+        Log.debug(`Authorizing ${this.clientName()} new access token`);
         const response = await super.authorize();
-        Log.debug('Authorized new access token', { response });
+        Log.debug(`Authorized ${this.clientName()} new access token`, { response });
         return response;
     }
     async handleAuthorizationCodeRedirect(request, session) {
-        Log.debug('Handling Authorization Code flow redirect', {
+        Log.debug(`Handling ${this.clientName()} Authorization Code flow redirect`, {
             request,
             session
         });
         return super.handleAuthorizationCodeRedirect(request, session);
     }
     async refreshTokenGrant(token) {
-        Log.debug('Refreshing expired access token', { token });
+        Log.debug(`Refreshing expired ${this.clientName()} access token`, {
+            token
+        });
         const refreshed = await super.refreshTokenGrant(token);
-        Log.debug('Received refreshed access token', { token: refreshed });
+        Log.debug(`Received refreshed ${this.clientName()} access token`, {
+            token: refreshed
+        });
         return refreshed;
     }
     async request(url, method, body, headers, dPoPOptions) {

package/dist/OAuth2Plugin.d.ts

@@ -14,6 +14,8 @@ type Usage = {
     text?: string[];
 };
 export type Configuration<C extends OAuth2CLI.Credentials = OAuth2CLI.Credentials> = Plugin.Configuration & {
+    /** Human-readable name for client in messages. */
+    name?: string;
     /** OAuth 2.0/OpenID Connect credential set */
     credentials?: Partial<C>;
     /** Base URL for all non-absolute requests */
@@ -40,6 +42,11 @@ export declare class OAuth2Plugin<C extends OAuth2CLI.Credentials = OAuth2CLI.Cr
     [key: string]: unknown;
     private static names;
     private static registeredPorts;
+    private overrideName?;
+    /**
+     * @param name Human-readable name for client in messages. Must also be a
+     *   unique qui-cli plugin name.
+     */
     constructor(name?: string);
     private credentials?;
     private base_url?;

package/dist/OAuth2Plugin.js

@@ -8,6 +8,11 @@ export class OAuth2Plugin {
     name;
     static names = [];
     static registeredPorts = {};
+    overrideName;
+    /**
+     * @param name Human-readable name for client in messages. Must also be a
+     *   unique qui-cli plugin name.
+     */
     constructor(name = '@oauth2-cli/qui-cli') {
         this.name = name;
         if (OAuth2Plugin.names.includes(name)) {
@@ -54,6 +59,7 @@ export class OAuth2Plugin {
             }
             return c;
         }
+        this.overrideName = Plugin.hydrate(proposal.name, this.overrideName);
         this.credentials = hydrate(proposal.credentials, this.credentials);
         this.base_url = Plugin.hydrate(proposal.base_url, this.base_url);
         this.storage = Plugin.hydrate(proposal.storage, this.storage);
@@ -67,20 +73,23 @@ export class OAuth2Plugin {
             const url = requestish.URL.from(this.credentials.redirect_uri);
             if (url.hostname !== 'localhost' &&
                 !/^\/https?\/localhost(:\d+)?\//.test(url.pathname)) {
-                Log.warning(`The ${Colors.varName(this.env.redirect_uri)} value ${Colors.url(this.credentials.redirect_uri)} may not work: it ${Colors.keyword('must')} redirect to ${Colors.url('localhost')}`);
+                Log.warning(`The ${Colors.varName(this.env.redirect_uri)} value ${Colors.url(this.credentials.redirect_uri)} for ${this.overrideName || this.name} may not work: it ` +
+                    `${Colors.keyword('must')} redirect to ${Colors.url('localhost')}`);
             }
             if (url.protocol !== 'http:' &&
                 !/^\/http\/localhost(:\d+)?\//.test(url.pathname)) {
-                Log.warning(`The ${Colors.url(url.protocol)} protocol may not work without additional configuration. The ` +
-                    `server listening for the redirect is not automatically ` +
+                Log.warning(`The ${Colors.url(url.protocol)} protocol may not work without additional configuration. The out-` +
+                    `of-band server listening for the ` +
+                    `${this.overrideName || this.name} redirect is not automatically ` +
                     `provisioned with an SSL certificate`);
             }
             if (OAuth2Plugin.registeredPorts[url.port] &&
                 OAuth2Plugin.registeredPorts[url.port] !== this.name) {
                 Log.warning(`The port ${Colors.value(url.port)} has already been registered to another instance of this plugin ` +
-                    `named ${Colors.value(OAuth2Plugin.registeredPorts[url.port])}. This will likely cause a failure if both instances of the ` +
-                    `plugin are listening for redirects at relatively proximate ` +
-                    `moments in time.`);
+                    `named ${Colors.value(OAuth2Plugin.registeredPorts[url.port])}. This will likely cause a failure if both ` +
+                    `${this.overrideName || this.name} and ` +
+                    `${OAuth2Plugin.registeredPorts[url.port]} are listening for ` +
+                    `redirects at relatively proximate moments in time.`);
             }
         }
     }
@@ -154,27 +163,33 @@ export class OAuth2Plugin {
     get client() {
         if (!this._client) {
             if (!this.credentials?.client_id) {
-                throw new Error(`A ${Colors.varName(this.env.client_id)} ${Colors.keyword('must')} be configured.`);
+                throw new Error(`A ${Colors.varName(this.env.client_id)} ${Colors.keyword('must')} ` +
+                    `be configured for ${this.overrideName || this.name}.`);
             }
             if (!this.credentials?.client_secret) {
-                throw new Error(`A ${Colors.varName(this.env.client_secret)} ${Colors.keyword('must')} be configured.`);
+                throw new Error(`A ${Colors.varName(this.env.client_secret)} ${Colors.keyword('must')} ` +
+                    `be configured for ${this.overrideName || this.name}.`);
             }
             if (!this.credentials?.redirect_uri) {
-                throw new Error(`A ${Colors.varName(this.env.redirect_uri)} ${Colors.keyword('must')} be configured.`);
+                throw new Error(`A ${Colors.varName(this.env.redirect_uri)} ${Colors.keyword('must')} ` +
+                    `be configured for ${this.overrideName || this.name}.`);
             }
             if (!this.credentials?.issuer) {
                 if (!this.credentials?.authorization_endpoint) {
                     throw new Error(`Either an ${Colors.varName(this.env.issuer)} or ` +
                         `${Colors.varName(this.env.authorization_endpoint)} ` +
-                        `${Colors.keyword('must')} be configured.`);
+                        `${Colors.keyword('must')} be configured for ` +
+                        `${this.overrideName || this.name}.`);
                 }
                 if (!this.credentials?.token_endpoint) {
                     throw new Error(`Either an ${Colors.varName(this.env.issuer)} or ` +
                         `${Colors.varName(this.env.token_endpoint)} ` +
-                        `${Colors.keyword('must')} be configured.`);
+                        `${Colors.keyword('must')} be configured for ` +
+                        `${this.overrideName || this.name}.`);
                 }
             }
             this._client = this.instantiateClient({
+                name: this.overrideName || this.name,
                 credentials: this.credentials,
                 base_url: this.base_url,
                 inject: this.inject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oauth2-cli/qui-cli",
-  "version": "0.7.6",
+  "version": "0.7.9",
   "description": "@qui-cli/plugin wrapper for oauth2-cli",
   "homepage": "https://github.com/battis/oauth2-cli/tree/main/packages/qui-cli#readme",
   "repository": {
@@ -17,7 +17,7 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "@qui-cli/colors": "^3.2.3",
-    "oauth2-cli": "0.8.3",
+    "oauth2-cli": "0.8.4",
     "requestish": "0.1.1"
   },
   "devDependencies": {