Fund: Bug: `createRetryStream` is not a function

Describe the bug

Node.js version: v16.18.1
OS & version: macOS

The Stream API documentation suggests that a third argument of createRetryStream is available for retry streams at https://github.com/sindresorhus/got/blob/39273481b67be41207c4efc31fc36e289eb53c88/documentation/3-streams.md#createretrystream. Also see

got/source/as-promise/index.ts

Lines 137 to 154 in 3e82b50

    
           request.once('retry', (newRetryCount: number, error: RequestError) => { 
        
           	firstRequest = undefined; 
        
           	const newBody = request.options.body; 
        
           	if (previousBody === newBody && is.nodeStream(newBody)) { 
        
           		error.message = 'Cannot retry with consumed body stream'; 
        
           		onError(error); 
        
           		return; 
        
           	} 
        
           	// This is needed! We need to reuse `request.options` because they can get modified! 
        
           	// For example, by calling `promise.json()`. 
        
           	normalizedOptions = request.options; 
        
           	makeRequest(newRetryCount); 
        
           });

Related to #1691 – and possible also #2073, #1691, and #1852.

Actual behavior

The documentation suggests this third argument exists, but it does not and usage of it results in the error createRetryStream is not a function.

Expected behavior

It should function as documented, merging options passed, e.g. createRetryStream({ url: 'https://some-new-url.com' });.

Checklist

I have read the documentation.
I have tried my code with the latest version of Node.js and Got.

Sindre Sorhus/got

Bug: createRetryStream is not a function

Describe the bug

Actual behavior

Expected behavior

Checklist

How does funding with Polar work?

Backer

Contributor

Maintainer

	request.once('retry', (newRetryCount: number, error: RequestError) => {
	firstRequest = undefined;

	const newBody = request.options.body;

	if (previousBody === newBody && is.nodeStream(newBody)) {
	error.message = 'Cannot retry with consumed body stream';

	onError(error);
	return;
	}

	// This is needed! We need to reuse `request.options` because they can get modified!
	// For example, by calling `promise.json()`.
	normalizedOptions = request.options;

	makeRequest(newRetryCount);
	});

Sindre Sorhus/got

Bug: createRetryStream is not a function

Describe the bug

Actual behavior

Expected behavior

Checklist

How does funding with Polar work?

Backer

Why does "Fund on completion" require GitHub login?

When is the invoice due for "Fund on completion"?

What happens if the issue is never completed?

Do I get any extra benefits by funding?

Do I get progress updates?

Contributor

Do I get a reward?

Is rewards guaranteed?

Maintainer

How can I get funding like this for my open source initiatives?