fix: reject a 503 document status with DocumentNotReadyError, as released

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

Author: hive-bot

CHANGELOG.md

@@ -338,9 +338,6 @@ 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.
 - The document ID is now URL-encoded in the request paths of the document
   status and download methods.
 - `extraBodyParameters` (and `extraRequestParameters`) of `translateText()` and

src/translator.ts

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

tests/offline/translateDocument.test.ts

@@ -270,15 +270,14 @@ describe('Translator.translateDocumentGetStatus', () => {
         expect(status.done()).toBe(true);
     });
 
-    it('throws DeepLError, not DocumentNotReadyError, when the server answers 503', async () => {
+    it('throws 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).toBeInstanceOf(deepl.DocumentNotReadyError);
         expect(error.httpStatusCode).toBe(503);
     });
 });
@@ -325,6 +324,14 @@ describe('Translator.getDocumentStatus', () => {
             'Not found, message: nope',
         );
     });
+
+    it('throws DocumentNotReadyError when the server answers 503', async () => {
+        nock(serverUrl).post('/v2/document/doc-id').reply(503);
+
+        await expect(makeTranslator({ maxRetries: 0 }).getDocumentStatus(handle)).rejects.toThrow(
+            deepl.DocumentNotReadyError,
+        );
+    });
 });
 
 describe('Translator.translateDocumentWaitUntilDone', () => {