fix: add version to copy file options annotation (#885)

docs/files.md

@@ -766,6 +766,12 @@ target folder.
 client.files.copy('12345', '0', {name: 'Renamed file.png'}, callback);
 ```
 
+You can specify specific file version to copy by passing optional `version` parameter.
+
+```js
+client.files.copy('12345', '0', {version: '1'}, callback);
+```
+
 ## Delete a File
 
 Calling the

src/managers/files.ts

@@ -12,9 +12,9 @@ import httpStatusCodes from 'http-status';
 import { Readable, Writable } from 'stream';
 import urlTemplate from 'url-template';
 import BoxClient from '../box-client';
+import * as schemas from "../schemas";
 import errors from '../util/errors';
 import urlPath from '../util/url-path';
-import * as schemas from "../schemas";
 
 const ChunkedUploader = require('../chunked-uploader');
 
@@ -512,6 +512,7 @@ class Files {
 	 * @param {string} newParentID - The Box ID for the new parent folder. '0' to copy to All Files.
 	 * @param {Object} [options] - Optional parameters for the copy operation, can be left null in most cases
 	 * @param {string} [options.name] - A new name to use if there is an identically-named item in the new parent folder
+	 * @param {string} [options.version] - An optional ID of the specific file version to copy
 	 * @param {Function} [callback] - passed the new file info if call was successful
 	 * @returns {Promise<Object>} A promise resolving to the new file object
 	 */
@@ -521,6 +522,7 @@ class Files {
 		options?:
 			| {
 					name?: string;
+					version?: string;
 			  }
 			| Function,
 		callback?: Function

tests/lib/managers/files-test.js

@@ -783,13 +783,15 @@ describe('Files', function() {
 		it('should make POST request to copy the folder with optional parameters when passed', function() {
 
 			var name = 'rename on copy';
+			var version = '1';
 
 			expectedParams.body.name = name;
+			expectedParams.body.version = version;
 
 			sandbox.stub(boxClientFake, 'wrapWithDefaultHandler').returnsArg(0);
 			sandbox.mock(boxClientFake).expects('post')
 				.withArgs('/files/1234/copy', expectedParams);
-			files.copy(FILE_ID, NEW_PARENT_ID, {name});
+			files.copy(FILE_ID, NEW_PARENT_ID, {name, version});
 		});
 
 		it('should wrap with default handler when called', function() {