@transloadit/node 4.1.9 → 4.3.0

package/README.md

@@ -112,6 +112,28 @@ npx transloadit assemblies replay --steps new-steps.json ASSEMBLY_ID
 npx transloadit assemblies replay --reparse-template ASSEMBLY_ID
 ```
 
+### Linting Assembly Instructions
+
+Lint Assembly Instructions locally using the same linter as the API.
+
+```bash
+# From a JSON file (full instructions or steps-only)
+npx transloadit assemblies lint --steps steps.json
+
+# From stdin
+cat steps.json | npx transloadit assemblies lint
+
+# Merge template content before linting
+npx transloadit assemblies lint --template TEMPLATE_ID --steps steps.json
+
+# Treat warnings as fatal; apply fixes (overwrites files / stdout for stdin)
+npx transloadit assemblies lint --fatal warning --fix --steps steps.json
+```
+
+When both `--template` and steps input are provided, Transloadit merges the template content with
+the provided steps before linting, matching the API's runtime behavior. If the template sets
+`allow_steps_override=false`, providing steps will fail with `TEMPLATE_DENIES_STEPS_OVERRIDE`.
+
 ### Managing Templates
 
 ```bash
@@ -260,6 +282,28 @@ try {
 
 You can find [details about your executed Assemblies here](https://transloadit.com/assemblies).
 
+### Resuming interrupted uploads
+
+If an upload was interrupted, you can resume it by providing the original `assemblyUrl` and the
+same input mapping. Resume relies on matching `fieldname`, `filename`, and `size`, so keep input
+names stable and pass the same files. Only path-based inputs resume; Buffer/string/stream uploads
+start a new tus upload automatically.
+
+You can pass the same upload and progress options as `createAssembly` (such as `chunkSize`,
+`uploadConcurrency`, `waitForCompletion`, `timeout`, `onUploadProgress`, and `onAssemblyProgress`).
+When `waitForCompletion` is `true`, the SDK will poll and resolve once the Assembly is finished.
+
+```javascript
+const status = await transloadit.resumeAssemblyUploads({
+  assemblyUrl: 'https://api2.transloadit.com/assemblies/ASSEMBLY_ID',
+  files: {
+    file1: '/PATH/TO/FILE.jpg',
+    file2: '/PATH/TO/FILE2.jpg',
+  },
+  uploadConcurrency: 2,
+})
+```
+
 ## Examples
 
 - [Upload and resize image](https://github.com/transloadit/node-sdk/blob/main/examples/resize_an_image.ts)
@@ -394,6 +438,42 @@ See also:
 - [API documentation](https://transloadit.com/docs/api/assemblies-post/)
 - Error codes and retry logic below
 
+#### async lintAssemblyInstructions(options)
+
+Lint Assembly Instructions locally using the same linter as the API.
+If you provide a `templateId`, the template content is fetched and merged with your instructions
+before linting (matching the API's runtime merge behavior). If the template sets
+`allow_steps_override=false`, providing steps will throw `TEMPLATE_DENIES_STEPS_OVERRIDE`.
+
+The `options` object accepts:
+
+- `assemblyInstructions` - Assembly Instructions as a JSON string, a full instructions object, or a steps-only object.
+  If no `steps` property is present, the object is treated as steps.
+- `templateId` - Optional template ID to merge before linting.
+- `fatal` - `'error' | 'warning'` (default: `'error'`). When set to `'warning'`, warnings are treated as fatal.
+- `fix` - Apply auto-fixes where possible. If `true`, the result includes `fixedInstructions`.
+
+The method returns:
+
+- `success` - `true` when no fatal issues are found.
+- `issues` - Array of lint issues (each includes `code`, `type`, `row`, `column`, and `desc`).
+- `fixedInstructions` - The fixed JSON string when `fix` is `true` (steps-only inputs return steps-only JSON).
+
+Example:
+
+```js
+const result = await transloadit.lintAssemblyInstructions({
+  assemblyInstructions: {
+    resize: { robot: '/image/resize', use: ':original', width: 100, height: 100 },
+  },
+  fatal: 'warning',
+})
+
+if (!result.success) {
+  console.log(result.issues)
+}
+```
+
 #### async listAssemblies(params)
 
 Retrieve Assemblies according to the given `params`.
@@ -677,7 +757,7 @@ If you want to retry on other errors, please see the [retry example code](exampl
 This project uses [debug](https://github.com/visionmedia/debug) so you can run node with the `DEBUG=transloadit` evironment variable to enable verbose logging. Example:
 
 ```bash
-DEBUG=transloadit* npx tsx examples/template_api.ts
+DEBUG=transloadit* node examples/template_api.ts
 ```
 
 ## Maintainers

package/dist/Transloadit.d.ts

@@ -5,18 +5,19 @@ import { ApiError } from './ApiError.ts';
 import type { AssemblyIndexItem, AssemblyStatus } from './alphalib/types/assemblyStatus.ts';
 import type { BaseResponse, BillResponse, CreateAssemblyParams, CreateTemplateCredentialParams, CreateTemplateParams, EditTemplateParams, ListAssembliesParams, ListedTemplate, ListTemplateCredentialsParams, ListTemplatesParams, OptionalAuthParams, PaginationListWithCount, ReplayAssemblyNotificationParams, ReplayAssemblyNotificationResponse, ReplayAssemblyParams, ReplayAssemblyResponse, TemplateCredentialResponse, TemplateCredentialsResponse, TemplateResponse } from './apiTypes.ts';
 import InconsistentResponseError from './InconsistentResponseError.ts';
+import type { LintAssemblyInstructionsInput, LintAssemblyInstructionsResult } from './lintAssemblyInstructions.ts';
 import PaginationStream from './PaginationStream.ts';
 export { HTTPError, MaxRedirectsError, ParseError, ReadError, RequestError, TimeoutError, UploadError, } from 'got';
 export type { AssemblyStatus } from './alphalib/types/assemblyStatus.ts';
 export * from './apiTypes.ts';
 export { InconsistentResponseError, ApiError };
+export type { LintAssemblyInstructionsResult, LintFatalLevel } from './lintAssemblyInstructions.ts';
 export interface UploadProgress {
     uploadedBytes?: number | undefined;
     totalBytes?: number | undefined;
 }
 export type AssemblyProgress = (assembly: AssemblyStatus) => void;
-export interface CreateAssemblyOptions {
-    params?: CreateAssemblyParams;
+interface AssemblyUploadOptions {
     files?: {
         [name: string]: string;
     };
@@ -29,18 +30,29 @@ export interface CreateAssemblyOptions {
     timeout?: number;
     onUploadProgress?: (uploadProgress: UploadProgress) => void;
     onAssemblyProgress?: AssemblyProgress;
-    assemblyId?: string;
     /**
-     * Optional AbortSignal to cancel the assembly creation and upload.
+     * Optional AbortSignal to cancel the upload and any follow-up polling.
      * When aborted, any in-flight HTTP requests and TUS uploads will be cancelled.
      */
     signal?: AbortSignal;
 }
+export interface CreateAssemblyOptions extends AssemblyUploadOptions {
+    params?: CreateAssemblyParams;
+    assemblyId?: string;
+}
+export interface ResumeAssemblyUploadsOptions extends AssemblyUploadOptions {
+    assemblyUrl: string;
+}
 export interface AwaitAssemblyCompletionOptions {
     onAssemblyProgress?: AssemblyProgress;
     timeout?: number;
     interval?: number;
     startTimeMs?: number;
+    /**
+     * Optional assembly URL to poll instead of the configured client endpoint.
+     * Useful when resuming an Assembly created on a different host/region.
+     */
+    assemblyUrl?: string;
     /**
      * Optional AbortSignal to cancel polling.
      * When aborted, the polling loop will stop and throw an AbortError.
@@ -53,6 +65,12 @@ export interface AwaitAssemblyCompletionOptions {
      */
     onPoll?: () => boolean | undefined;
 }
+export interface LintAssemblyInstructionsOptions extends Omit<LintAssemblyInstructionsInput, 'template'> {
+    /**
+     * Template ID to merge with the provided instructions before linting.
+     */
+    templateId?: string;
+}
 export interface SmartCDNUrlOptions {
     /**
      * Workspace slug
@@ -107,7 +125,19 @@ export declare class Transloadit {
      * @param opts assembly options
      */
     createAssembly(opts?: CreateAssemblyOptions): CreateAssemblyPromise;
-    awaitAssemblyCompletion(assemblyId: string, { onAssemblyProgress, timeout, startTimeMs, interval, signal, onPoll, }?: AwaitAssemblyCompletionOptions): Promise<AssemblyStatus>;
+    /**
+     * Lint Assembly Instructions locally.
+     *
+     * If a templateId is provided, the template content is merged with the instructions,
+     * just like the API. When a template sets `allow_steps_override=false`, providing
+     * `steps` will throw a TEMPLATE_DENIES_STEPS_OVERRIDE error.
+     *
+     * The `assemblyInstructions` input may be a JSON string, a full instructions object,
+     * or a steps-only object (missing the `steps` property).
+     */
+    lintAssemblyInstructions(options: LintAssemblyInstructionsOptions): Promise<LintAssemblyInstructionsResult>;
+    resumeAssemblyUploads(opts: ResumeAssemblyUploadsOptions): Promise<AssemblyStatus>;
+    awaitAssemblyCompletion(assemblyId: string, { onAssemblyProgress, timeout, startTimeMs, interval, assemblyUrl, signal, onPoll, }?: AwaitAssemblyCompletionOptions): Promise<AssemblyStatus>;
     maybeThrowInconsistentResponseError(message: string): void;
     /**
      * Cancel the assembly
@@ -150,6 +180,7 @@ export declare class Transloadit {
     getAssembly(assemblyId: string, options?: {
         signal?: AbortSignal;
     }): Promise<AssemblyStatus>;
+    private _fetchAssemblyStatus;
     /**
      * Create a Credential
      *

package/dist/Transloadit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transloadit.d.ts","sourceRoot":"","sources":["../src/Transloadit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Transloadit.d.ts","sourceRoot":"","sources":["../src/Transloadit.ts"],"names":[],"mappings":"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"}

package/dist/Transloadit.js

@@ -1,7 +1,8 @@
 import * as assert from 'node:assert';
 import { randomUUID } from 'node:crypto';
 import { constants, createReadStream } from 'node:fs';
-import { access } from 'node:fs/promises';
+import { access, stat } from 'node:fs/promises';
+import { basename } from 'node:path';
 import { setTimeout as delay } from 'node:timers/promises';
 import { getSignedSmartCdnUrl, signParamsSync } from '@transloadit/utils/node';
 import debug from 'debug';
@@ -15,6 +16,7 @@ import { ApiError } from "./ApiError.js";
 import { assemblyIndexSchema, assemblyStatusSchema } from "./alphalib/types/assemblyStatus.js";
 import { zodParseWithContext } from "./alphalib/zodParseWithContext.js";
 import InconsistentResponseError from "./InconsistentResponseError.js";
+import { lintAssemblyInstructions as lintAssemblyInstructionsInternal } from "./lintAssemblyInstructions.js";
 import PaginationStream from "./PaginationStream.js";
 import PollingTimeoutError from "./PollingTimeoutError.js";
 import { sendTusRequest } from "./tus.js";
@@ -26,6 +28,55 @@ export { InconsistentResponseError, ApiError };
 const log = debug('transloadit');
 const logWarn = debug('transloadit:warn');
 const { version } = packageJson;
+const getUploadKey = (fieldname, filename, size) => {
+    if (!fieldname || !filename || size == null)
+        return null;
+    return JSON.stringify([fieldname, filename, size]);
+};
+const getSizeFromValue = (value) => {
+    if (typeof value === 'string')
+        return Buffer.byteLength(value);
+    if (Buffer.isBuffer(value))
+        return value.length;
+    if (value instanceof ArrayBuffer)
+        return value.byteLength;
+    if (ArrayBuffer.isView(value))
+        return value.byteLength;
+    return undefined;
+};
+const toReadableUpload = (label, value) => {
+    const readable = isReadableStream(value);
+    if (!readable && isStream(value)) {
+        throw new Error(`Upload named "${label}" is not a Readable stream`);
+    }
+    return readable ? value : intoStream(value);
+};
+const buildStreamsMap = (descriptors) => Object.fromEntries(descriptors.map((descriptor) => {
+    if (descriptor.path) {
+        const stream = createReadStream(descriptor.path);
+        return [descriptor.label, { stream, path: descriptor.path }];
+    }
+    const value = descriptor.value;
+    if (value == null) {
+        throw new Error(`Upload named "${descriptor.label}" has no data`);
+    }
+    const stream = toReadableUpload(descriptor.label, value);
+    return [descriptor.label, { stream }];
+}));
+const pauseStreams = (streamsMap) => {
+    for (const { stream } of Object.values(streamsMap)) {
+        stream.pause();
+    }
+};
+const createStreamErrorPromise = (streamsMap) => {
+    const promise = new Promise((_resolve, reject) => {
+        for (const { stream } of Object.values(streamsMap)) {
+            stream.on('error', reject);
+        }
+    });
+    promise.catch(() => { });
+    return promise;
+};
 // Not sure if this is still a problem with the API, but throw a special error type so the user can retry if needed
 function checkAssemblyUrls(result) {
     if (result.assembly_url == null || result.assembly_ssl_url == null) {
@@ -35,6 +86,13 @@ function checkAssemblyUrls(result) {
 function getHrTimeMs() {
     return Number(process.hrtime.bigint() / 1000000n);
 }
+function getAssemblyIdFromUrl(assemblyUrl) {
+    const match = assemblyUrl.match(/\/assemblies\/([^/?#]+)/);
+    if (!match) {
+        throw new Error(`Invalid assembly URL: ${assemblyUrl}`);
+    }
+    return match[1] ?? '';
+}
 function checkResult(result) {
     // In case server returned a successful HTTP status code, but an `error` in the JSON object
     // This happens sometimes, for example when createAssembly with an invalid file (IMPORT_FILE_ERROR)
@@ -105,39 +163,29 @@ export class Transloadit {
         const promise = (async () => {
             this._lastUsedAssemblyUrl = `${this._endpoint}${urlSuffix}`;
             await pMap(Object.entries(files), async ([, path]) => access(path, constants.F_OK | constants.R_OK), { concurrency: 5 });
-            // Convert uploads to streams
-            const streamsMap = Object.fromEntries(Object.entries(uploads).map(([label, value]) => {
-                const isReadable = isReadableStream(value);
-                if (!isReadable && isStream(value)) {
-                    // https://github.com/transloadit/node-sdk/issues/92
-                    throw new Error(`Upload named "${label}" is not a Readable stream`);
-                }
-                return [label, isReadableStream(value) ? value : intoStream(value)];
-            }));
-            // Wrap in object structure (so we can store whether it's a pathless stream or not)
-            const allStreamsMap = Object.fromEntries(Object.entries(streamsMap).map(([label, stream]) => [label, { stream }]));
-            // Create streams from files too
-            for (const [label, path] of Object.entries(files)) {
-                const stream = createReadStream(path);
-                allStreamsMap[label] = { stream, path }; // File streams have path
-            }
+            const descriptors = [
+                ...Object.entries(files).map(([label, path]) => ({
+                    label,
+                    path,
+                    filename: basename(path),
+                })),
+                ...Object.entries(uploads).map(([label, value]) => ({
+                    label,
+                    filename: label,
+                    value,
+                })),
+            ];
+            const allStreamsMap = buildStreamsMap(descriptors);
             const allStreams = Object.values(allStreamsMap);
             // Pause all streams
-            for (const { stream } of allStreams) {
-                stream.pause();
-            }
+            pauseStreams(allStreamsMap);
             // If any stream emits error, we want to handle this and exit with error.
             // This promise races against createAssemblyAndUpload() below via Promise.race().
             // When createAssemblyAndUpload wins the race, this promise becomes "orphaned" -
             // it's no longer awaited, but stream error handlers remain attached.
             // The no-op catch prevents Node's unhandled rejection warning if a stream
             // errors after the race is already won.
-            const streamErrorPromise = new Promise((_resolve, reject) => {
-                for (const { stream } of allStreams) {
-                    stream.on('error', reject);
-                }
-            });
-            streamErrorPromise.catch(() => { });
+            const streamErrorPromise = createStreamErrorPromise(allStreamsMap);
             const createAssemblyAndUpload = async () => {
                 const result = await this._remoteJson({
                     urlSuffix,
@@ -179,9 +227,130 @@ export class Transloadit {
         // This allows the user to use or log the assemblyId even before it has been created for easier debugging
         return Object.assign(promise, { assemblyId: effectiveAssemblyId });
     }
-    async awaitAssemblyCompletion(assemblyId, { onAssemblyProgress = () => { }, timeout, startTimeMs = getHrTimeMs(), interval = 1000, signal, onPoll, } = {}) {
+    /**
+     * Lint Assembly Instructions locally.
+     *
+     * If a templateId is provided, the template content is merged with the instructions,
+     * just like the API. When a template sets `allow_steps_override=false`, providing
+     * `steps` will throw a TEMPLATE_DENIES_STEPS_OVERRIDE error.
+     *
+     * The `assemblyInstructions` input may be a JSON string, a full instructions object,
+     * or a steps-only object (missing the `steps` property).
+     */
+    async lintAssemblyInstructions(options) {
+        const { templateId, ...rest } = options;
+        if (!templateId) {
+            return await lintAssemblyInstructionsInternal(rest);
+        }
+        const template = await this.getTemplate(templateId);
+        return await lintAssemblyInstructionsInternal({
+            ...rest,
+            template: template.content,
+        });
+    }
+    async resumeAssemblyUploads(opts) {
+        const { assemblyUrl, files = {}, uploads = {}, chunkSize: requestedChunkSize = Number.POSITIVE_INFINITY, uploadConcurrency = 10, timeout = 24 * 60 * 60 * 1000, // 1 day
+        waitForCompletion = false, onUploadProgress = () => { }, onAssemblyProgress = () => { }, signal, } = opts;
+        const startTimeMs = getHrTimeMs();
+        getAssemblyIdFromUrl(assemblyUrl);
+        const assembly = await this._fetchAssemblyStatus({ url: assemblyUrl, signal });
+        const statusUrl = assembly.assembly_ssl_url ?? assembly.assembly_url ?? assemblyUrl;
+        const finishedKeys = new Set();
+        for (const upload of assembly.uploads ?? []) {
+            const key = getUploadKey(upload.field ?? null, upload.basename ?? null, upload.size);
+            if (key)
+                finishedKeys.add(key);
+        }
+        for (const upload of assembly.tus_uploads ?? []) {
+            if (!upload.finished)
+                continue;
+            const key = getUploadKey(upload.fieldname, upload.filename, upload.size);
+            if (key)
+                finishedKeys.add(key);
+        }
+        const resumeUrls = new Map();
+        for (const upload of assembly.tus_uploads ?? []) {
+            if (upload.finished)
+                continue;
+            if (!upload.upload_url)
+                continue;
+            const key = getUploadKey(upload.fieldname, upload.filename, upload.size);
+            if (key)
+                resumeUrls.set(key, upload.upload_url);
+        }
+        const descriptors = [];
+        await pMap(Object.entries(files), async ([label, path]) => {
+            await access(path, constants.F_OK | constants.R_OK);
+            const info = await stat(path);
+            descriptors.push({
+                label,
+                path,
+                filename: basename(path),
+                size: info.size,
+            });
+        }, { concurrency: 5 });
+        for (const [label, value] of Object.entries(uploads)) {
+            descriptors.push({
+                label,
+                filename: label,
+                size: isReadableStream(value) ? undefined : getSizeFromValue(value),
+                value,
+            });
+        }
+        const descriptorsToUpload = descriptors.filter((descriptor) => {
+            const key = getUploadKey(descriptor.label, descriptor.filename, descriptor.size ?? null);
+            return key ? !finishedKeys.has(key) : true;
+        });
+        const uploadUrlsByLabel = {};
+        for (const descriptor of descriptorsToUpload) {
+            if (!descriptor.path)
+                continue;
+            const key = getUploadKey(descriptor.label, descriptor.filename, descriptor.size ?? null);
+            if (!key)
+                continue;
+            const uploadUrl = resumeUrls.get(key);
+            if (uploadUrl)
+                uploadUrlsByLabel[descriptor.label] = uploadUrl;
+        }
+        const streamsMap = buildStreamsMap(descriptorsToUpload);
+        pauseStreams(streamsMap);
+        if (Object.keys(streamsMap).length > 0) {
+            const streamErrorPromise = createStreamErrorPromise(streamsMap);
+            const uploadPromise = sendTusRequest({
+                streamsMap,
+                assembly,
+                requestedChunkSize,
+                uploadConcurrency,
+                onProgress: onUploadProgress,
+                signal,
+                uploadUrls: uploadUrlsByLabel,
+            });
+            await Promise.race([uploadPromise, streamErrorPromise]);
+        }
+        const latestAssembly = await this._fetchAssemblyStatus({ url: statusUrl, signal });
+        if (!waitForCompletion)
+            return latestAssembly;
+        if (latestAssembly.assembly_id == null) {
+            throw new InconsistentResponseError('Server returned an assembly response without an assembly_id after resuming uploads');
+        }
+        const awaitResult = await this.awaitAssemblyCompletion(latestAssembly.assembly_id, {
+            timeout,
+            onAssemblyProgress,
+            startTimeMs,
+            assemblyUrl: statusUrl,
+            signal,
+        });
+        checkResult(awaitResult);
+        return awaitResult;
+    }
+    async awaitAssemblyCompletion(assemblyId, { onAssemblyProgress = () => { }, timeout, startTimeMs = getHrTimeMs(), interval = 1000, assemblyUrl, signal, onPoll, } = {}) {
         assert.ok(assemblyId);
         let lastResult;
+        const fetchAssemblyStatus = () => {
+            return assemblyUrl
+                ? this._fetchAssemblyStatus({ url: assemblyUrl, signal })
+                : this.getAssembly(assemblyId, { signal });
+        };
         while (true) {
             // Check if caller wants to stop polling early
             if (onPoll?.() === false && lastResult) {
@@ -191,7 +360,7 @@ export class Transloadit {
             if (signal?.aborted) {
                 throw signal.reason ?? new DOMException('Aborted', 'AbortError');
             }
-            const result = await this.getAssembly(assemblyId, { signal });
+            const result = await fetchAssemblyStatus();
             lastResult = result;
             // If 'ok' is not in result, it implies a terminal state (e.g., error, completed, canceled).
             // If 'ok' is present, then we check if it's one of the non-terminal polling states.
@@ -327,13 +496,21 @@ export class Transloadit {
      * @returns the retrieved Assembly
      */
     async getAssembly(assemblyId, options) {
-        const rawResult = await this._remoteJson({
-            urlSuffix: `/assemblies/${assemblyId}`,
+        return await this._fetchAssemblyStatus({
+            assemblyId,
             signal: options?.signal,
         });
+    }
+    async _fetchAssemblyStatus({ assemblyId, url, signal, }) {
+        const rawResult = await this._remoteJson({
+            url,
+            urlSuffix: url ? undefined : `/assemblies/${assemblyId}`,
+            signal,
+        });
         const parsedResult = zodParseWithContext(assemblyStatusSchema, rawResult);
         if (!parsedResult.success) {
-            this.maybeThrowInconsistentResponseError(`The API responded with data that does not match the expected schema while getting Assembly: ${assemblyId}.\n${parsedResult.humanReadable}`);
+            const label = assemblyId ?? url ?? 'unknown';
+            this.maybeThrowInconsistentResponseError(`The API responded with data that does not match the expected schema while getting Assembly: ${label}.\n${parsedResult.humanReadable}`);
         }
         checkAssemblyUrls(rawResult);
         return rawResult;
@@ -597,21 +774,33 @@ export class Transloadit {
                     logWarn('HTTP error', statusCode, body);
                     // check whether we should retry
                     // https://transloadit.com/blog/2012/04/introducing-rate-limiting/
-                    if (typeof body === 'object' &&
+                    const retryAfterHeader = err.response?.headers?.['retry-after'];
+                    const retryAfterSeconds = typeof retryAfterHeader === 'string' ? Number(retryAfterHeader) : undefined;
+                    const retryInFromInfo = typeof body === 'object' &&
                         body != null &&
-                        'error' in body &&
                         'info' in body &&
                         typeof body.info === 'object' &&
                         body.info != null &&
                         'retryIn' in body.info &&
                         typeof body.info.retryIn === 'number' &&
-                        Boolean(body.info.retryIn) &&
-                        retryCount < this._maxRetries && // 413 taken from https://transloadit.com/blog/2012/04/introducing-rate-limiting/
+                        body.info.retryIn > 0
+                        ? body.info.retryIn
+                        : undefined;
+                    const retryInSec = retryInFromInfo ??
+                        (typeof retryAfterSeconds === 'number' && retryAfterSeconds > 0
+                            ? retryAfterSeconds
+                            : undefined);
+                    const shouldRetry = retryCount < this._maxRetries && // 413 taken from https://transloadit.com/blog/2012/04/introducing-rate-limiting/
                         // todo can 413 be removed?
-                        ((statusCode === 413 && body.error === 'RATE_LIMIT_REACHED') || statusCode === 429)) {
-                        const { retryIn: retryInSec } = body.info;
-                        logWarn(`Rate limit reached, retrying request in approximately ${retryInSec} seconds.`);
-                        const retryInMs = 1000 * (retryInSec * (1 + 0.1 * Math.random()));
+                        ((statusCode === 413 &&
+                            body &&
+                            typeof body === 'object' &&
+                            body.error === 'RATE_LIMIT_REACHED') ||
+                            statusCode === 429);
+                    if (shouldRetry) {
+                        const retryDelaySec = retryInSec ?? 1;
+                        logWarn(`Rate limit reached, retrying request in approximately ${retryDelaySec} seconds.`);
+                        const retryInMs = 1000 * (retryDelaySec * (1 + 0.1 * Math.random()));
                         await delay(retryInMs);
                         // Retry
                     }