opencode-qwencode-auth 1.0.0 → 1.1.0

package/README.md

@@ -1,8 +1,13 @@
 # 🤖 Qwen Code OAuth Plugin for OpenCode
 
+![npm version](https://img.shields.io/npm/v/opencode-qwencode-auth)
 ![License](https://img.shields.io/github/license/gustavodiasdev/opencode-qwencode-auth)
 ![GitHub stars](https://img.shields.io/github/stars/gustavodiasdev/opencode-qwencode-auth)
 
+<p align="center">
+  <img src="assets/screenshot.png" alt="OpenCode with Qwen Code" width="800">
+</p>
+
 **Authenticate OpenCode CLI with your qwen.ai account.** This plugin enables you to use Qwen3-Coder models with **2,000 free requests per day** - no API key or credit card required!
 
 [🇧🇷 Leia em Português](./README.pt-BR.md)
@@ -23,18 +28,14 @@
 
 ## 🚀 Installation
 
-### 1. Add the plugin to OpenCode
-
-Edit `~/.opencode/package.json`:
+### 1. Install the plugin
 
-```json
-{
-  "dependencies": {
-    "opencode-qwencode-auth": "github:gustavodiasdev/opencode-qwencode-auth"
-  }
-}
+```bash
+cd ~/.opencode && npm install opencode-qwencode-auth
 ```
 
+### 2. Enable the plugin
+
 Edit `~/.opencode/opencode.jsonc`:
 
 ```json
@@ -43,12 +44,6 @@ Edit `~/.opencode/opencode.jsonc`:
 }
 ```
 
-### 2. Install dependencies
-
-```bash
-cd ~/.opencode && npm install
-```
-
 ## 🔑 Usage
 
 ### 1. Login

package/README.pt-BR.md

@@ -1,8 +1,13 @@
 # 🤖 Qwen Code OAuth Plugin para OpenCode
 
+![npm version](https://img.shields.io/npm/v/opencode-qwencode-auth)
 ![License](https://img.shields.io/github/license/gustavodiasdev/opencode-qwencode-auth)
 ![GitHub stars](https://img.shields.io/github/stars/gustavodiasdev/opencode-qwencode-auth)
 
+<p align="center">
+  <img src="assets/screenshot.png" alt="OpenCode com Qwen Code" width="800">
+</p>
+
 **Autentique o OpenCode CLI com sua conta qwen.ai.** Este plugin permite usar modelos Qwen3-Coder com **2.000 requisições gratuitas por dia** - sem API key ou cartão de crédito!
 
 [🇺🇸 Read in English](./README.md)
@@ -23,18 +28,14 @@
 
 ## 🚀 Instalação
 
-### 1. Adicione o plugin ao OpenCode
-
-Edite `~/.opencode/package.json`:
+### 1. Instale o plugin
 
-```json
-{
-  "dependencies": {
-    "opencode-qwencode-auth": "github:gustavodiasdev/opencode-qwencode-auth"
-  }
-}
+```bash
+cd ~/.opencode && npm install opencode-qwencode-auth
 ```
 
+### 2. Habilite o plugin
+
 Edite `~/.opencode/opencode.jsonc`:
 
 ```json
@@ -43,12 +44,6 @@ Edite `~/.opencode/opencode.jsonc`:
 }
 ```
 
-### 2. Instale as dependências
-
-```bash
-cd ~/.opencode && npm install
-```
-
 ## 🔑 Uso
 
 ### 1. Login

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-qwencode-auth",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Qwen OAuth authentication plugin for OpenCode - Access Qwen3-Coder models with your qwen.ai account",
   "module": "index.ts",
   "type": "module",

package/src/errors.ts

@@ -0,0 +1,75 @@
+/**
+ * Erros customizados do plugin Qwen Auth
+ *
+ * Fornece mensagens amigáveis para o usuário em vez de JSON bruto da API.
+ * Detalhes técnicos só aparecem com OPENCODE_QWEN_DEBUG=1.
+ */
+
+const REAUTH_HINT =
+  'Execute "npx opencode-qwencode-auth" ou "qwen-code auth login" para re-autenticar.';
+
+// ============================================
+// Erro de Autenticação
+// ============================================
+
+export type AuthErrorKind = 'token_expired' | 'refresh_failed' | 'auth_required';
+
+const AUTH_MESSAGES: Record<AuthErrorKind, string> = {
+  token_expired: `[Qwen] Token expirado. ${REAUTH_HINT}`,
+  refresh_failed: `[Qwen] Falha ao renovar token. ${REAUTH_HINT}`,
+  auth_required: `[Qwen] Autenticacao necessaria. ${REAUTH_HINT}`,
+};
+
+export class QwenAuthError extends Error {
+  public readonly kind: AuthErrorKind;
+  public readonly technicalDetail?: string;
+
+  constructor(kind: AuthErrorKind, technicalDetail?: string) {
+    super(AUTH_MESSAGES[kind]);
+    this.name = 'QwenAuthError';
+    this.kind = kind;
+    this.technicalDetail = technicalDetail;
+  }
+}
+
+// ============================================
+// Erro de API
+// ============================================
+
+function classifyApiStatus(statusCode: number): string {
+  if (statusCode === 401 || statusCode === 403) {
+    return `[Qwen] Token invalido ou expirado. ${REAUTH_HINT}`;
+  }
+  if (statusCode === 429) {
+    return '[Qwen] Limite de requisicoes atingido. Aguarde alguns minutos antes de tentar novamente.';
+  }
+  if (statusCode >= 500) {
+    return `[Qwen] Servidor Qwen indisponivel (erro ${statusCode}). Tente novamente em alguns minutos.`;
+  }
+  return `[Qwen] Erro na API Qwen (${statusCode}). Verifique sua conexao e tente novamente.`;
+}
+
+export class QwenApiError extends Error {
+  public readonly statusCode: number;
+  public readonly technicalDetail?: string;
+
+  constructor(statusCode: number, technicalDetail?: string) {
+    super(classifyApiStatus(statusCode));
+    this.name = 'QwenApiError';
+    this.statusCode = statusCode;
+    this.technicalDetail = technicalDetail;
+  }
+}
+
+// ============================================
+// Helper de log condicional
+// ============================================
+
+/**
+ * Loga detalhes técnicos apenas quando debug está ativo.
+ */
+export function logTechnicalDetail(detail: string): void {
+  if (process.env.OPENCODE_QWEN_DEBUG === '1') {
+    console.debug('[Qwen Debug]', detail);
+  }
+}

package/src/index.ts

@@ -23,6 +23,9 @@ import {
   tokenResponseToCredentials,
   refreshAccessToken,
 } from './qwen/oauth.js';
+import { logTechnicalDetail } from './errors.js';
+export { QwenAuthError, QwenApiError } from './errors.js';
+export type { AuthErrorKind } from './errors.js';
 
 // ============================================
 // Helpers
@@ -102,14 +105,25 @@ export const QwenAuthPlugin = async (_input: unknown) => {
             accessToken = refreshed.accessToken;
             saveCredentials(refreshed);
           } catch (e) {
-            console.error('[Qwen] Token refresh failed:', e);
+            const detail = e instanceof Error ? e.message : String(e);
+            logTechnicalDetail(`Token refresh falhou: ${detail}`);
+            // Não continuar com token expirado - tentar fallback
+            accessToken = undefined;
           }
         }
 
         // Fallback para credenciais do qwen-code
         if (!accessToken) {
           const creds = checkExistingCredentials();
-          if (creds) accessToken = creds.accessToken;
+          if (creds) {
+            accessToken = creds.accessToken;
+          } else {
+            console.warn(
+              '[Qwen] Token expirado e sem credenciais alternativas. ' +
+              'Execute "npx opencode-qwencode-auth" ou "qwen-code auth login" para re-autenticar.'
+            );
+            return null;
+          }
         }
 
         if (!accessToken) return null;

package/src/plugin/auth.ts

@@ -10,6 +10,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 
 import type { QwenCredentials } from '../types.js';
 import { refreshAccessToken, isCredentialsExpired } from '../qwen/oauth.js';
+import { logTechnicalDetail } from '../errors.js';
 
 /**
  * Get the path to the credentials file
@@ -58,7 +59,7 @@ export function loadCredentials(): QwenCredentials | null {
 
     return null;
   } catch (error) {
-    console.error('Error loading Qwen credentials:', error);
+    logTechnicalDetail(`Erro ao carregar credenciais: ${error}`);
     return null;
   }
 }
@@ -102,7 +103,7 @@ export async function getValidCredentials(): Promise<QwenCredentials | null> {
       credentials = await refreshAccessToken(credentials.refreshToken);
       saveCredentials(credentials);
     } catch (error) {
-      console.error('Failed to refresh token:', error);
+      logTechnicalDetail(`Falha no refresh: ${error}`);
       return null;
     }
   }

package/src/plugin/client.ts

@@ -12,6 +12,7 @@ import type {
   StreamChunk
 } from '../types.js';
 import { getValidCredentials, loadCredentials, isCredentialsExpired } from './auth.js';
+import { QwenAuthError, QwenApiError } from '../errors.js';
 
 /**
  * QwenClient - Makes authenticated API calls to Qwen
@@ -66,7 +67,7 @@ export class QwenClient {
    */
   private getAuthHeader(): string {
     if (!this.credentials) {
-      throw new Error('Not authenticated. Please run the OAuth flow first.');
+      throw new QwenAuthError('auth_required');
     }
     return `Bearer ${this.credentials.accessToken}`;
   }
@@ -87,7 +88,7 @@ export class QwenClient {
     if (!this.credentials) {
       const initialized = await this.initialize();
       if (!initialized) {
-        throw new Error('No valid Qwen credentials found. Please authenticate first.');
+        throw new QwenAuthError('auth_required');
       }
     }
 
@@ -106,7 +107,7 @@ export class QwenClient {
     if (!response.ok) {
       const errorText = await response.text();
       this.log('API Error:', response.status, errorText);
-      throw new Error(`Qwen API error: ${response.status} - ${errorText}`);
+      throw new QwenApiError(response.status, errorText);
     }
 
     const data = await response.json();
@@ -122,7 +123,7 @@ export class QwenClient {
     if (!this.credentials) {
       const initialized = await this.initialize();
       if (!initialized) {
-        throw new Error('No valid Qwen credentials found. Please authenticate first.');
+        throw new QwenAuthError('auth_required');
       }
     }
 
@@ -142,7 +143,7 @@ export class QwenClient {
     if (!response.ok) {
       const errorText = await response.text();
       this.log('API Error:', response.status, errorText);
-      throw new Error(`Qwen API error: ${response.status} - ${errorText}`);
+      throw new QwenApiError(response.status, errorText);
     }
 
     const reader = response.body?.getReader();

package/src/qwen/oauth.ts

@@ -9,6 +9,7 @@ import { randomBytes, createHash, randomUUID } from 'node:crypto';
 
 import { QWEN_OAUTH_CONFIG } from '../constants.js';
 import type { QwenCredentials } from '../types.js';
+import { QwenAuthError, logTechnicalDetail } from '../errors.js';
 
 /**
  * Device authorization response from Qwen OAuth
@@ -87,9 +88,8 @@ export async function requestDeviceAuthorization(
 
   if (!response.ok) {
     const errorData = await response.text();
-    throw new Error(
-      `Device authorization failed: ${response.status} ${response.statusText}. Response: ${errorData}`
-    );
+    logTechnicalDetail(`Device auth HTTP ${response.status}: ${errorData}`);
+    throw new QwenAuthError('auth_required', `HTTP ${response.status}: ${errorData}`);
   }
 
   const result = await response.json() as DeviceAuthorizationResponse;
@@ -193,7 +193,8 @@ export async function refreshAccessToken(refreshToken: string): Promise<QwenCred
 
   if (!response.ok) {
     const errorText = await response.text();
-    throw new Error(`Token refresh failed: ${response.status} - ${errorText}`);
+    logTechnicalDetail(`Token refresh HTTP ${response.status}: ${errorText}`);
+    throw new QwenAuthError('refresh_failed', `HTTP ${response.status}: ${errorText}`);
   }
 
   const data = await response.json() as TokenResponse;