fix(types): match actual v3 API response structure

The actual DeepL v3 API response does not include `source_lang` or
`target_langs` at the root level. These fields only exist within the
`dictionaries` array. This commit adds:

1. **GlossaryApiResponse** - Raw API response type matching actual structure
2. **normalizeGlossaryInfo()** - Transforms API response to add derived fields
3. Updates API client to use normalization for all glossary endpoints

The normalization extracts source_lang and target_langs from the
dictionaries array for convenient access in the CLI.

Note: Newly created glossaries may have empty `dictionaries` arrays,
suggesting the v3 API processes glossaries asynchronously.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: sjsyrek

src/api/deepl-client.ts

@@ -15,6 +15,7 @@ import {
   GlossaryInfo,
   GlossaryLanguagePair,
 } from '../types';
+import { normalizeGlossaryInfo, GlossaryApiResponse } from '../types/glossary.js';
 
 interface ProxyConfig {
   protocol?: 'http' | 'https';
@@ -514,7 +515,7 @@ export class DeepLClient {
     }
 
     try {
-      const response = await this.makeRequest<GlossaryInfo>(
+      const response = await this.makeRequest<GlossaryApiResponse>(
         'POST',
         '/v3/glossaries',
         {
@@ -526,7 +527,7 @@ export class DeepLClient {
         }
       );
 
-      return response;
+      return normalizeGlossaryInfo(response);
     } catch (error) {
       throw this.handleError(error);
     }
@@ -537,12 +538,12 @@ export class DeepLClient {
    */
   async listGlossaries(): Promise<GlossaryInfo[]> {
     try {
-      const response = await this.makeRequest<{ glossaries: GlossaryInfo[] }>(
+      const response = await this.makeRequest<{ glossaries: GlossaryApiResponse[] }>(
         'GET',
         '/v3/glossaries'
       );
 
-      return response.glossaries || [];
+      return (response.glossaries || []).map(normalizeGlossaryInfo);
     } catch (error) {
       throw this.handleError(error);
     }
@@ -553,12 +554,12 @@ export class DeepLClient {
    */
   async getGlossary(glossaryId: string): Promise<GlossaryInfo> {
     try {
-      const response = await this.makeRequest<GlossaryInfo>(
+      const response = await this.makeRequest<GlossaryApiResponse>(
         'GET',
         `/v3/glossaries/${glossaryId}`
       );
 
-      return response;
+      return normalizeGlossaryInfo(response);
     } catch (error) {
       throw this.handleError(error);
     }

src/types/glossary.ts

@@ -5,18 +5,26 @@
 import { Language } from './common.js';
 
 /**
- * Glossary Info (v3 API structure)
- * Supports both single and multiple target languages
+ * Raw API response from DeepL v3 glossary endpoints
+ * This matches the actual API response structure
  */
-export interface GlossaryInfo {
+export interface GlossaryApiResponse {
   glossary_id: string;
   name: string;
-  source_lang: Language;
-  target_langs: Language[]; // Always array (even for single target)
+  ready?: boolean; // Indicates if glossary is ready (may be absent)
   dictionaries: LanguagePairInfo[];
   creation_time: string;
 }
 
+/**
+ * Normalized Glossary Info (used internally in the CLI)
+ * Adds derived fields for convenience
+ */
+export interface GlossaryInfo extends GlossaryApiResponse {
+  source_lang: Language; // Derived from dictionaries
+  target_langs: Language[]; // Derived from dictionaries (unique targets)
+}
+
 /**
  * Language pair within glossary
  */
@@ -26,6 +34,33 @@ export interface LanguagePairInfo {
   entry_count: number;
 }
 
+/**
+ * Transform raw API response to normalized GlossaryInfo
+ * Derives source_lang and target_langs from dictionaries
+ */
+export function normalizeGlossaryInfo(response: GlossaryApiResponse): GlossaryInfo {
+  // Extract unique source and target languages from dictionaries
+  const sourceLangs = new Set<Language>();
+  const targetLangs = new Set<Language>();
+
+  response.dictionaries.forEach(dict => {
+    sourceLangs.add(dict.source_lang.toLowerCase() as Language);
+    targetLangs.add(dict.target_lang.toLowerCase() as Language);
+  });
+
+  // For v3 glossaries, there should be one source language
+  // (but dictionaries might be empty if still processing)
+  const source_lang = sourceLangs.size > 0
+    ? Array.from(sourceLangs)[0]!
+    : 'en' as Language; // Fallback (shouldn't happen in practice)
+
+  return {
+    ...response,
+    source_lang,
+    target_langs: Array.from(targetLangs),
+  };
+}
+
 /**
  * Helper: Check if glossary has multiple language pairs
  */