fix: throw DeepLError on HTTP 503 from the document status request

The status request mapped HTTP 503 to DocumentNotReadyError, which is
meant for document downloads only. It now throws DeepLError.

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

Author: hive-bot

CHANGELOG.md

@@ -187,6 +187,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   a status the library did not know made `translateDocument()` and
   `translateDocumentWaitUntilDone()` stop polling and reject with
   `unknown error`.
+- An HTTP 503 response to `translateDocumentGetStatus()` and `getDocumentStatus()`
+  now throws `DeepLError`; before it threw `DocumentNotReadyError`, which is meant
+  for document downloads only.
 - `extraBodyParameters` (and `extraRequestParameters`) of `translateText()` and
   `uploadDocument()`/`translateDocument()` now replace every parameter of the same
   name set by the library. Before, parameters appended after the languages and

src/translator.ts

@@ -476,7 +476,7 @@ export class Translator {
             `/v2/document/${handle.documentId}`,
             { data },
         );
-        await checkStatusCode(statusCode, content, false, true);
+        await checkStatusCode(statusCode, content);
         return parseDocumentStatus(content);
     }
 

tests/offline/translateDocument.test.ts

@@ -218,6 +218,18 @@ describe('Translator.translateDocumentGetStatus', () => {
 
         expect([status.status, status.ok(), status.done()]).toEqual([expected, true, false]);
     });
+
+    it('throws DeepLError, not DocumentNotReadyError, when the server answers 503', async () => {
+        nock(serverUrl).post('/v2/document/doc-id').reply(503);
+
+        const error = await makeDeeplClient({ maxRetries: 0 })
+            .translateDocumentGetStatus(handle)
+            .catch((e) => e);
+
+        expect(error).toBeInstanceOf(deepl.DeepLError);
+        expect(error).not.toBeInstanceOf(deepl.DocumentNotReadyError);
+        expect(error.httpStatusCode).toBe(503);
+    });
 });
 
 describe('Translator.getDocumentStatus', () => {