Download remote file over HTTP to the file system of a Server. Download is efficient, runs in chunks writing data as available directly to FS via stream without holding it in RAM. If error or timeout occurred — unfinished file will get removed from file system.

/*
 * @locus Server
 */

FilesCollection#load(url [, opts, callback, proceedAfterUpload]);

Write file to file system from remote URL (external resource) and add record to FilesCollection

• url {String} - Full address to file, like https://example.com/sample.png
• opts {Object} - Recommended properties:
  • opts.fileName {String} - File name with extension, like name.ext
  • opts.headers {Object} - Request HTTP headers, to use when requesting the file
  • opts.meta {Object} - Object with custom meta-data
  • opts.type {String} - Mime-type, like image/png, if not set - mime-type will be taken from response headers
  • opts.size {Number} - File size in bytes, if not set - file size will be taken from response headers
  • opts.userId {String} - UserId, default: null
  • opts.fileId {String} - id, optional - if not set - Random.id() will be used
  • opts.timeout {Number} - timeout in milliseconds, default: 360000 (6 mins); Set to 0 to disable timeout; Disabling timeout not recommended, sockets won't get closed until server rebooted
• callback {Function} - Triggered after first byte is received. With error, and fileRef, where fileRef is a new record from DB
• proceedAfterUpload {Boolean} - Proceed onAfterUpload hook (if defined) after external source is loaded to FS
• Returns {FilesCollection} - Current FilesCollection instance

/*
 * @locus Server
 */

import { FilesCollection } from 'meteor/ostrio:files';
const imagesCollection = new FilesCollection({collectionName: 'images'});

imagesCollection.load('https://raw.githubusercontent.com/veliovgroup/Meteor-Files/master/logo.png', {
  fileName: 'logo.png',
  fileId: 'abc123myId', //optional
  timeout: 60000, // optional timeout
  meta: {}
});