v2.0.0

This release has breaking changes. This release has a few notable breaking changes. Please take care when upgrading!

require syntax changes

The import style of this library has been changed to support es module syntax. This provides both forward compatibility with es modules, and better supports the TypeScript and Babel ecosystems. As a result, the import syntax has changed:

Old Code

const storage = require('@google-cloud/storage')();
// or...
const Storage = require('@google-cloud/storage');
const storage = new Storage({
  // config...
});

New Code

const {Storage} = require('@google-cloud/storage');
const storage = new Storage({
  // config...
});

bucket.upload no longer accepts URLs

To better support a variety of HTTP clients, the remote fetching functionality of bucket.upload has been removed. It can be replaced with your favorite HTTP client.

Old Code

bucket.upload('https://example.com/images/image.png', function(err, file, res) {
  // handle upload...
});

New Code

const request = require('request');
const file = bucket.file(name);
const writeStream = file.createWriteStream();
request(url).pipe(writeStream);

Breaking changes

• semver: do not support upload() from url (#337)
• fix: drop support for node.js 4.x and 9.x (#282)

Features

• refactor(ts): merge initial TypeScript conversion (#334)
• feat: Add Storage#getServiceAccount(). (#331)
• Kms sample (#209)

Bug fixes

• fix: gzip and Cache-Control headers in upload sample (#225)
• fix: move this.[ROLE]s initialization from Acl to AclAccessorRoleMethods (#252)
• fix: signedURL cname (#210) (#234)

Internal / Testing Changes

• chore(deps): update dependency nyc to v13 (#341)
• fix(deps): update dependency @google-cloud/common to ^0.23.0 (#340)
• test: throw on deprecation (#319)
• chore(deps): update dependency eslint-config-prettier to v3 (#336)
• fix(deps): update dependency gcs-resumable-upload to ^0.12.0 (#317)
• Fix system tests for string comparisons (#328)
• chore: ignore package-lock.json (#326)
• chore: update renovate config (#322)
• chore: regen lock files (#318)
• chore(deps): lock file maintenance (#313)
• chore: move mocha options to mocha.opts (#311)
• chore(deps): lock file maintenance (#309)
• test: use strictEqual in tests (#306)
• chore(deps): update dependency eslint-plugin-node to v7 (#305)
• chore(deps): lock file maintenance (#303)
• chore(deps): lock file maintenance (#285)
• fix: test meant to assert err msg exists (#280)
• fix(deps): update dependency yargs to v12 (#270)
• fix(deps): update dependency uuid to v3.3.2 (#269)
• chore: update gcs-resumable-upload to 0.11.1 (#265)
• fix(deps): update dependency uuid to v3.3.0 (#262)
• chore(deps): update dependency sinon to v6 (#263)
• Configure Renovate (#250)
• refactor: drop repo-tool as an exec wrapper (#258)
• chore: update sample lockfiles (#256)
• fix: update linking for samples (#254)
• chore(package): update eslint to version 5.0.0 (#253)
• refactor(es6): Refactor constructor pattern as ES6 class (#246)
• Update @google-cloud/common to the latest version 🚀 (#226)
• system-tests: fix channel test. (#243)
• refactor: Update to the latest version of nodejs-common and gcs-resumable-upload (#202)
• Fix permission of bash script for Kokoro (#223)
• chore(package): update nyc to version 12.0.2 (#216)
• chore: fix prettier incompatibility (#211)

v1.7.0

Features

• (#165): Check if $HOME is writable before starting a resumable upload.
• (#174): Introduce a directory option to getFiles().
• (#179): Introduce KMS.

Fixes

• (#160): Return apiResponse argument from bucket.upload(). (Thanks for pointing this out, @scragg0x!)
• (#168): Don't require a content type for bucket.combine(). (Thanks, @zbjornson!)
• (#169): Properly encode signed URLs. (Thanks again to @zbjornson!)

v1.6.0

Features

• (#125): Allow setting additional request parameters during a Bucket#upload() from a remote file. (Thanks, @ImmaculatePine!)
• (#129): Support the resumable action for File#getSignedUrl().
• (#133): Add auto options to automatically determine contentType and gzip settings for File#createWriteStream(). (Thanks, @calvinmetcalf!)

Fixes

• (#122) Normalize arguments when using new.
• (#128): Remove leading gs:// parts of a File name provided to a File object.
• Update dependencies to mitigate possible security issues.

@google-cloud/storage v1.5.2

Fixes

• (#110): Wait for incoming File download stream to end completely before confirming data integrity.

@google-cloud/storage v1.5.1

Fixes

• (#99): Generated signed policies correctly.

@google-cloud/storage v1.5.0

Features

• (#63): Upload a file to your bucket from a URL. Idea and implementation by @Kiricon, thank you! 🙇
• (#81): Update the customer-supplied encryption key for a file with file#rotateEncryptionKey().
• (#82): Allow unauthenticated File downloads.
• (#91): Signed policies and URLs no longer require a JSON key file.

Fixes

• (#57): Correct "Requester Pays" and "User Project" terminology in our documentation.
• (#61): Correct typo in documentation. (Thanks, @Crazometer!)
• (#78): Correct userProject type definition. (Nice catch, @tejohnso!)
• (#79): Explain extensionHeaders better for file#getSignedUrl(). (Thanks for pointing this out, @teemeh!)

@google-cloud/storage v1.4.0

Features

• (#38): Add support for PubSub notifications.

Refer to the nodejs-storage API reference documentation for details.

@google-cloud/storage v1.3.1

• (#2604, #2611, #25, #33) Update gcs-resumable-upload.

Refer to the nodejs-storage API reference documentation for details.

@google-cloud/storage v1.3.0

• Add runnable samples in samples/ directory.
• Replace use of deprecated new Buffer with Buffer.from.
• Change to a new linter (ESLint) and code style formatter (prettify).
• Update docs to use JSDoc 3.
• Migrate to the googleapis/nodejs-storage repository.

Refer to the nodejs-storage API reference documentation for details.

@google-cloud/storage v1.2.1

• Strip leading slashes from a File path. (Thanks, @sabrehagen!)
  • googleapis/google-cloud-node#2440
  • googleapis/google-cloud-node#2470