CHANGELOG.md

Changelog

npm history

7.14.0 (2024-10-29)

Features

• Add support for restore token (#2548) (8241e91)
• Adds integration tests for Universe Domain configuration (#2538) (53db6ba)
• Adds integration tests for Universe Domain configuration with (53db6ba)
• storage: Add support for 'skipIfExists' option for downloadMany (#2526) (729efb2)

7.13.0 (2024-09-17)

Features

• storage: Add support for 'fields' query parameter to getFiles (#2521) (f78fe92)

Bug Fixes

• retry: Export RETRYABLE_ERR_FN_DEFAULT (#2517) (db890fd)

7.12.1 (2024-08-07)

Bug Fixes

• deps: Update fast-xml-parser to 4.4.1 due to security vulnerability (#2505) (b97d474)

7.12.0 (2024-07-15)

Features

• Add function to allow user to set destination in transfer manager (#2497) (dc1e488)

7.11.3 (2024-07-09)

Bug Fixes

• Error serialization in resumable-upload.ts (#2493) (c2e555c)
• Handle unhandled error in startResumableUpload_ (#2495) (d5257ba)
• Make CreateBucketRequest extend from BucketMetadata to allow all… (#2489) (013a5a4)

7.11.2 (2024-06-07)

Bug Fixes

• Support uint8array in file.save (#2480) (1477fe1)

7.11.1 (2024-05-21)

Bug Fixes

• Add missing projectIdentifier to GetServiceAccountOptions (#2468) (d49e9d2)
• Allow files in directories to be downloaded onto local machine (#2199) (9f62429)
• Do not set customEndpoint if apiEndpoint === default (#2460) (b4dbd73)
• Improve GetFilesResponse interface (#2466) (918db28)

7.11.0 (2024-05-03)

Features

• Add ability to enable hierarchical namespace on buckets (#2453) (4e5726f)

7.10.2 (2024-04-26)

Bug Fixes

• Use correct indices for file.from and fix tests to verify names (#2449) (d4240fa)

7.10.1 (2024-04-22)

Bug Fixes

• Change copyoptions type (#2439) (2ebd7ac)
• Expand types of custom metadata within FileMetadata (#2442) (1d434a9)

7.10.0 (2024-04-15)

Features

• Add ability to create a File object from URL (#2432) (1b71fcc)
• Allow setting contentEncoding during compose (#2431) (6e81e05)

Bug Fixes

• Destroy pipeline streams when returned stream errors (#2437) (fe1ac65)
• Remove extraneous mime-types package in favor of mime (#2435) (63a71f2)

7.9.0 (2024-03-18)

Features

• Add ability to configure and utilize soft-delete and restore (#2425) (7da5a7d)

7.8.0 (2024-03-07)

Features

• Add includeFoldersAsPrefixes for managed folders (#2413) (3044d3c)
• Base TPC Support (#2397) (a3f4891)

Bug Fixes

• Cannot read properties of null (reading length) in stream-shift (#2422) (11ebe2b)
• Do not automatically set overrideUnlockedRetention (#2421) (c781bdc)

7.7.0 (2023-11-29)

Features

• Implement object retention lock for bucket / files (#2365) (c140868)

Bug Fixes

• TransferManager#downloadFileInChunks issues (#2373) (65950f3)

7.6.0 (2023-11-08)

Features

• Resume Resumable Uploads (#2333) (2ba4009)

7.5.0 (2023-10-30)

Features

• Support autoclass v2.1 (#2325) (6572ce9)

7.4.0 (2023-10-24)

Features

• Support building in CJS and ESM formats (#2296) (c848076)

7.3.2 (2023-10-24)

Bug Fixes

• Close Open Handle for Empty Objects (#2338) (c51cd94)

7.3.1 (2023-10-19)

Bug Fixes

• Add user-agent header to transfer manager and resumable upload (#2334) (0520867)
• deps: Update dependency retry-request to v7 (#2327) (f20ef3c)
• Destroy sockets to stop memory leaking when stream errors (#2336) (04939ee)

7.3.0 (2023-10-11)

Features

• Add transfer manager MPU sample, adjust defaults, prepare for GA (#2318) (a7d09c1)

Bug Fixes

• Simplify the code for downloadInChunks (#2323) (6519929)

7.2.0 (2023-10-05)

Features

• Add headers option to MPU (#2303) (7f58f30)
• Transfer Manager Metrics (#2305) (9be3b6a)

Bug Fixes

• Make sure destination uses posix separator instead of win (#2304) (1d4ea74)

7.1.0 (2023-09-07)

Features

• Export ApiError (#2291) (c1d1b35)
• Support iterables in file@save (4356dd0)
• Support iterables in file@save (49327ff)
• Support iterables in file@save (c0d9d58)

Bug Fixes

• File#save iterable fixes (#2293) (87c3f41)
• deps: Update dependency @google-cloud/paginator to v5 (#2263) (0c9b342)
• deps: Update dependency @google-cloud/projectify to v4 (#2264) (c881bae)
• deps: Update dependency @google-cloud/promisify to v4 (#2262) (9d46ff3)
• deps: Update dependency @google-cloud/pubsub to v4 (#2256) (18282bb)

Miscellaneous Chores

• Release 7.1.0 (#2274) (e0f45c2)

7.0.1 (2023-08-07)

Bug Fixes

• Export new types from index.ts (#2258) (93d2a0f)

7.0.0 (2023-08-03)

⚠ BREAKING CHANGES

• Make node 14 the minimum supported version (#2244)
• Add stronger typings to metadata (#2234)
• Remove extend and Treat Provided Options as Mutable (#2204)
• Stronger typing for lifecycle rules (#2215)
• Do not return responsebody in delete, only raw response (#2236)
• Remove extraneous validation in favor of server errors (#2237)
• Mark bucket.setLabels and associated interfaces as deprecated (#2214)
• Disable source maps for smaller bundle size (#2240)

Features

• Make node 14 the minimum supported version (#2244) (f48dcd2)

6.12.0 (2023-07-13)

Features

• Add header for deno runtime for metrics tracking (#2220) (5083920)
• MPU for transfer manager (#2192) (ae83421)

6.11.0 (2023-06-02)

Features

• Add support for matchGlob list option (#2206) (79dd839)

6.10.1 (2023-05-10)

Performance Improvements

• Improve Multiple Chunk Upload Performance (#2185) (3b2b877)

6.10.0 (2023-05-02)

Features

• Retry Socket Connection Timeouts on Node 20+ (#2187) (733b560)

6.9.5 (2023-03-30)

Bug Fixes

• Check that err.message is a string before attempting indexOf (#2173) (130818d)
• V4 Signing Errors with exactly 7 day expiry (#2170) (f930998)

6.9.4 (2023-03-02)

Bug Fixes

• Refactor createReadStream to remove unnecessary stream (#2153) (2c97310)

6.9.3 (2023-02-15)

Bug Fixes

• Reduce memory footprint of deleteFiles by utilizing getFilesStream and using smaller queue of promises (#2147) (f792f25)

6.9.2 (2023-02-06)

Bug Fixes

• Correctly handle if a user has no permissions when calling iam.testPermissions (#2140) (cce902d)

6.9.1 (2023-01-24)

Bug Fixes

• Setting file metadata is conditionally idempotent on ifmetagenerationmatch not ifgenerationmatch (#2131) (f20c28c)

6.9.0 (2023-01-04)

Features

• Add ability to upload entire directory, add samples for upload … (#2118) (b0f32ce)

6.8.0 (2022-12-07)

Features

• Implement parallel operations (#2067) (#2109) (ce15b5e)

6.7.0 (2022-11-03)

Features

• Support autoclass (#2078) (7e83580)

6.6.0 (2022-10-25)

Features

• crc32c: Convenient Method For Reading Files (#2095) (2145c81)

Bug Fixes

• Remove async from final function which causes double invocation … (#2094) (1a3df98)

6.5.4 (2022-10-20)

Bug Fixes

• Revert STORAGE_EMULATOR_HOST handling (#2089) (48dce65)

6.5.3 (2022-10-18)

Bug Fixes

• Correct STORAGE_EMULATOR_HOST handling (#2069, #1314) (#2070) (c75b8b8)

6.5.2 (2022-09-23)

Bug Fixes

• Determine Content-Length Before Attempting Multi-chunk Upload (#2074) (666402a)

6.5.1 (2022-09-20)

Bug Fixes

• Revert skip validation (#2023) (70ab224)

6.5.0 (2022-09-15)

Features

• Add multiple lifecycle rules (#2062) (fbe2deb)

6.4.2 (2022-09-01)

Bug Fixes

• remove pip install statements (#1546) (#2049) (c90ba0f)
• truncated createReadStream through early end event (#2056) (a4716a4)

6.4.1 (2022-08-12)

Bug Fixes

• Remove pumpify (#2029) (edc1d64)
• Retry EPIPE Connection Errors + Attempt Retries in Resumable Upload Connection Errors (#2040) (ba35321)

6.4.0 (2022-08-10)

Features

• add functionality for passing preconditions at the function level (#1993) (21f173e)

6.3.0 (2022-08-01)

Features

• custom dual regions refactor implementation (#2012) (9a614fb)

6.2.3 (2022-07-13)

Bug Fixes

• force setMetadata calls to use promise version, invoke callbacks manually (#2000) (f488647)

6.2.2 (2022-06-29)

Bug Fixes

• correctly handle an empty file in download function (#1995) (f1a5a0b)

6.2.1 (2022-06-27)

Bug Fixes

• explicitly import URL so that .d.ts file is correctly generated (#1992) (a968f50)

6.2.0 (2022-06-22)

Features

• Convenient gs:// URI retrieval (#1987) (58fad6d)

Bug Fixes

• deps: update dependency @google-cloud/projectify to v3 (#1986) (71a61ec)
• deps: update dependency @google-cloud/pubsub to v3 (#1972) (004b97e)
• Requests Respect config.projectIdRequired === false (#1988) (8813369)

6.1.0 (2022-06-08)

Features

• support OLM Prefix/Suffix (#1847) (c22984c)

6.0.1 (2022-05-25)

Bug Fixes

• capture and throw on non-existent files (#1969) (52d81c0)

6.0.0 (2022-05-24)

⚠ BREAKING CHANGES

• update TypeScript
• remove deprecated fields
• remove configstore
• align resumable upload behavior
• utilize internalized CRC32C utilities
• drop node 10 support

Build System

• drop node 10 support (77fa8d9)

Code Refactoring

• align resumable upload behavior (77fa8d9)
• remove configstore (77fa8d9)
• remove deprecated fields (77fa8d9)
• utilize internalized CRC32C utilities (77fa8d9)

deps

• update TypeScript (77fa8d9)

5.20.5 (2022-05-19)

Bug Fixes

• chore: move uuid package to dependencies (#1952) (0ff5aa3)

5.20.4 (2022-05-18)

Bug Fixes

• revert native typescript mocha tests (#1947) (1d0ea7d)
• support empty object uploads for resumable upload (#1949) (da6016e)

5.20.3 (2022-05-17)

Bug Fixes

• move retrieval of package.json to utility function (#1941) (ac5cbdf)

5.20.2 (2022-05-17)

Bug Fixes

• use path.join and __dirname for require package.json (#1936) (b868762)

5.20.1 (2022-05-16)

Bug Fixes

• do not use import on package.json (#1932) (d0f0494)

5.20.0 (2022-05-16)

Features

• add x-goog-api-client headers for retry metrics (#1920) (0c7e4f6)

5.19.4 (2022-04-28)

Bug Fixes

• don't modify passed in options (#1895) (cd80ca3)

5.19.3 (2022-04-20)

Bug Fixes

• export idempotencystrategy and preconditionoptions from index (#1880) (8aafe04)

5.19.2 (2022-04-14)

Bug Fixes

• deleting, getting, and getting metadata for notifications (#1872) (451570e)

5.19.1 (2022-04-08)

Bug Fixes

• prevent retrying 200 response (#1857) (638a47b)

5.19.0 (2022-04-06)

Features

• Dual Region Support (#1814) (caf7ee5)

5.18.3 (2022-03-28)

Bug Fixes

• encode name portion when calling publicUrl function (#1828) (5522b35)
• fixed typo (#1803) (be70dae)

5.18.2 (2022-02-16)

Bug Fixes

• resumable uploads should respect autoRetry & multipart uploads should correctly use preconditions (#1779) (1e72586)

5.18.1 (2022-01-26)

Bug Fixes

• gcs-resumable-upload: Stop Duplicate Response Handlers on Retries (#1764) (fe44871)

5.18.0 (2022-01-18)

Features

• Expose chunkSize param for CreateResumableUploadOptions (#1754) (3acfd5b)

5.17.0 (2022-01-10)

Features

• add support for rpo (turbo replication) metadata field when cre… (#1648) (291e6ef)

Bug Fixes

• remove compodoc dev dependency (#1745) (809bf11)

5.16.1 (2021-11-29)

Bug Fixes

• change properties with function value to methods (#1715) (c365254)
• revert skip validation (#1718) (0c75e33)
• stop File.download from truncating output file on failure (#1720) (d77979b)

5.16.0 (2021-11-09)

Features

• improved error messages for resumable uploads (#1708) (50cdbb6)

Bug Fixes

• add scenario 3 conformance tests (#1702) (e16a3a5)
• retry uri creation dep update & conformance tests (#1700) (d265f8c)

5.15.6 (2021-11-05)

Bug Fixes

• add scenario 3 conformance tests (#1702) (e16a3a5)
• retry uri creation dep update & conformance tests (#1700) (d265f8c)

5.15.5 (2021-11-03)

Bug Fixes

• deps: update dependency mime to v3 (#1696) (f337208)
• explicitly define function type of getFilesStream (#1697) (c950c23)

5.15.4 (2021-11-01)

Bug Fixes

• check e is not null (#1692) (56ff485)

5.15.3 (2021-10-14)

Bug Fixes

• do not use src precondition options in copy. (#1666) (678ae77)

5.15.2 (2021-10-13)

Bug Fixes

• remove bucket preconditions from deleteFiles, it is a file operation not bucket (#1661) (6b7a06d)

5.15.1 (2021-10-12)

Bug Fixes

• check generation on source files not metageneration on bucket (#1654) (760231c)

5.15.0 (2021-10-07)

Features

• add support for useAuthWithCustomEndpoint option (#1645) (d11d6b4)

Bug Fixes

• update common dep (#1644) (793467f)

5.14.8 (2021-10-06)

Bug Fixes

• update common dep (#1644) (793467f)

5.14.7 (2021-10-06)

Bug Fixes

• file preconditions should respect ifGenerationMatch not ifMetagenerationMatch (#1642) (eb6f31f)

5.14.6 (2021-10-06)

Bug Fixes

• pass precondition opts to new file (#1638) (1523ca9)

5.14.5 (2021-10-01)

Bug Fixes

• fix logic for buckets that do not have a generation (#1634) (9069bdc)
• updated connection reset string (#1632) (b841d5b)

5.14.4 (2021-09-27)

Bug Fixes

• respect precondition settings from constructors (#1617) (6a48942)

5.14.3 (2021-09-22)

Bug Fixes

• set autoretry back to instance value at end of file functions (#1604) (db3b59d)

5.14.2 (2021-09-13)

Bug Fixes

• build: set default branch to main (#1587) (b39ce95)

5.14.1 (2021-09-08)

Bug Fixes

• types: remove duplicated definition of BucketOptions and make sure proper version is exported (#1583) (d8f4bc5)

5.14.0 (2021-08-26)

Features

• retries for conditionally idempotent operations (#1561) (653f4b4)

Bug Fixes

• allow retries of metadatata operations in system tests (#1568) (9398566)

5.13.2 (2021-08-26)

Bug Fixes

• update getLabels definition to actually allow no arguments when used in typescript (#1559) (176dbb5)

5.13.1 (2021-08-18)

Bug Fixes

• deps: update dependency date-and-time to v2 (#1537) (9d0d69e)

5.13.0 (2021-08-09)

Features

• Precondition checks (#1523) (7c24417)

5.12.0 (2021-08-03)

Features

• pass precondition parameters to gcs-resumable-upload (#1516) (65211dd)

5.11.1 (2021-08-02)

Bug Fixes

• don't retry non-idempotent functions (#1517) (c938795)

5.11.0 (2021-07-23)

Features

• retries for resumable bucket.upload and file.save (#1511) (9bf163c)

5.10.0 (2021-07-22)

Features

• retry multipart Bucket.upload (#1509) (730d0a0)

5.9.0 (2021-07-21)

Features

• customize retry behavior implementation (#1474) (#1493) (49008e3)

5.8.5 (2021-05-04)

Bug Fixes

• deps: updated gcs-resumable-upload dependency (#1459) (afaccc7)

5.8.4 (2021-04-19)

Bug Fixes

• deps: update dependency date-and-time to v1 (#1434) (91ee6ca)
• don't fail if ~/.config doesn't exist (#1428) (3cfaba1)

5.8.3 (2021-03-29)

Bug Fixes

• update CopyOptions type to include cacheControl, contentType and contentEncoding (#1426) (efa5bb8)

5.8.2 (2021-03-23)

Bug Fixes

• perf: pull hashes without refreshing metadata (#1419) (f3ec627)

5.8.1 (2021-03-02)

Bug Fixes

• deprecate options.promise and sync options with Service (#1391) (59cfe27)
• types: support metadata override in file.copy() (#1406) (dda6d30)

5.8.0 (2021-02-18)

Features

• adds support workload identity federation (#1404) (7d3a3f1)

5.7.4 (2021-02-01)

Bug Fixes

• specified acceptable types for File.save data parameter (#1388) (607f6c1)

5.7.3 (2021-01-22)

Bug Fixes

• retry multipart uploads on File.save() (#1385) (4dec8c1)

5.7.2 (2021-01-11)

Bug Fixes

• deprecated directory. prefix should be used instead (#1370) (fae4c06)

5.7.1 (2021-01-07)

Bug Fixes

• bump dependencies See #1372 for details (#1375) (7cf0264)

5.7.0 (2020-12-10)

Features

• support metadata updates from makePrivate() methods (#1355) (3db1e83)

Bug Fixes

• capitalize action in Bucket#addLifecycleRule (#1358) (205f39f)
• jsdoc for bucket (#1359) (5fa530a)

5.6.0 (2020-12-02)

Features

• allow ignoring 404 errors during delete() operations (#1347) (dab0e7d)

5.5.1 (2020-12-01)

Bug Fixes

• add publicUrl to exclude promisifyAll (#1339) (ea2c2c9)
• error if both storageClass and specific storage class name are provided (#1323) (91a65f8)
• only throw if storageClass and specific storage class name provide different values (#1346) (1765608)
• docs: explain manual pagination and add usage sample (#1317) (16b779d)

5.5.0 (2020-11-03)

Features

• accessibleAt v4 signed urls (#1328) (1e0295e)

5.4.0 (2020-10-29)

Features

• userAgent: allow for optional user agent to be provided (#1313) (13a064f)
• add custom time field in metadata sample (#1285) (9e3474f)
• add File#rename (#1311) (c77eaa3)
• public url of a file (#1324) (5ec256e)

Bug Fixes

• set customEndpoint for custom environments (#1316) (60910e1)
• deps: update dependency gaxios to v4 (#1322) (f9b16d8)
• moved publicUrl comment (#1327) (249ed2c)
• self-upload files for Unicode system tests (#1318) (e826a52)
• deps: update dependency duplexify to v4 (#1302) (1ce3d89)
• deps: update dependency yargs to v16 (#1289) (12f2133)
• types: add CreateBucketRequest.storageClass (#1299) (d854c26), closes #1248

5.3.0 (2020-08-24)

Features

• support noncurrent time object lifecycle condition (#1216) (d198aff)

5.2.0 (2020-08-10)

Features

• remove through2 dependency (#1240) (97c73dd)

Bug Fixes

• support request interceptors for file uploads (#1225) (aa4e4ec)
• deps: update dependency date-and-time to ^0.14.0 (#1263) (408aff9)

5.1.2 (2020-07-06)

Bug Fixes

• deps: update dependency through2 to v4 (#1226) (2be25e8)

5.1.1 (2020-06-19)

Bug Fixes

• deps: update dependency p-limit to v3 (#1210) (7da0379)
• update node issue template (#1220) (eaac92b)

5.1.0 (2020-06-11)

Features

• secrets: begin migration to secret manager from keystore (#1211) (11b16ae)
• allow setting timeouts on uploads (#1208) (01b3691)

Bug Fixes

• deps: update dependency @google-cloud/pubsub to v2 (#1201) (c684b2a)

5.0.1 (2020-05-20)

Bug Fixes

• StorageOptions.apiEndpoint overrides simple and resumable uploads (#1161) (cf8ea5c)
• types: assert in typescript 3.7 (#1198) (d5aa8b7)

5.0.0 (2020-05-13)

⚠ BREAKING CHANGES

• automatically detect contentType if not provided (#1190)
• drop keepAcl parameter in file copy (#1166)
• drop support for node.js 8.x

Features

• automatically detect contentType if not provided (#1190) (b31ba4a)
• enable bytes read tracking (#1074) (0776a04)

Bug Fixes

• bucket: Only disable resumable uploads for bucket.upload (fixes #1133) (#1135) (2c20148), closes /github.com/googleapis/nodejs-storage/pull/1135#issuecomment-620070038
• add whitespace to generateV4SignedPolicy (#1136) (dcee78b)
• apache license URL (#468) (#1151) (e8116d3)
• Point to team in correct org (#1185) (0bb1909)
• deps: update dependency @google-cloud/common to v3 (#1134) (774ac5c)
• deps: update dependency @google-cloud/paginator to v3 (#1131) (c1614d9)
• deps: update dependency @google-cloud/promisify to v2 (#1127) (06624a5)
• deps: update dependency uuid to v8 (#1170) (6a98d64)
• deps: update gcs-resumable-upload, remove gitnpm usage (#1186) (c78c9cd)
• v4-policy: encode special characters (#1169) (6e48539)
• sync to googleapis/conformance-tests@fa559a1 (#1167) (5500446), closes #1168

Miscellaneous Chores

• drop keepAcl parameter in file copy (#1166) (5a4044a)

Build System

• drop support for node.js 8.x (b80c025)

4.7.0 (2020-03-26)

Features

• add remove conditional binding (#1107) (2143705)
• v4 POST with signed policy (#1102) (a3d5b88), closes #1125

Bug Fixes

• deps: update dependency date-and-time to ^0.13.0 (#1106) (b759605)
• deps: update dependency gaxios to v3 (#1129) (5561452)
• types: wrap GetSignedUrlResponse (#1119) (0c7ac16)

4.6.0 (2020-03-13)

Features

• storage: Add versioning as optional metadata param of createBucket (#1090) (39869e3)

4.5.0 (2020-03-06)

Features

• v4: support v4 signed URL for GA (#1072) (79d7b8f), closes #1051 #1056 #1066 #1068 #1069 #1067 #1070

4.4.0 (2020-03-03)

Features

• bucket: support single source in combine (#1076) (#1085) (251a617)

4.3.2 (2020-03-02)

Bug Fixes

• deps: update dependency uuid to v7 (#1081) (c72d57f)
• tests: flaky getSignedPolicy tests (#1093) (531050a)

4.3.1 (2020-02-06)

Bug Fixes

• samples: fix overwritten IAM conditions sample (#1042) (25d839c)
• skip validation for server decompressed objects (#1063) (d6e3738)
• unhandled promise rejection warning in samples (#1056) (e95ec19)

4.3.0 (2020-01-21)

Features

• add support for CORS as a first class citizen (#1020) (9fee6d9)

Bug Fixes

• deps: update dependency date-and-time to ^0.12.0 (#1032) (a324564)
• a couple of typos from the refactorNodeSampleStorage branch (#1038) (8faa6c6)
• do not modify constructor options (#974) (4969148)
• refactor getMetadata sample into its own file (#1008) (6ed1af8)
• refactor getRetentionPolicy sample into its own file (#993) (47e4ad8)
• refactor getUniformBucketLevelAccess into its own file (#981) (0ba69f1)
• refactor rotateEncryptionKey sample into its own file (#1030) (afdf0fe)
• refactor uploadEncryptedFile sample into its own file (#1028) (ba4520b)
• refactoring disableUniformBucketLevelAccess into its own file (#980) (1481e20)

4.2.0 (2020-01-02)

Features

• iam: getIamPolicy to support requestedPolicyVersion (#960) (0f38f75)
• add support for Archive storage class (#908) (63f63f4)

Bug Fixes

• deps: pin TypeScript below 3.7.0 (#952) (1fea60c)
• add createBucket file and updated relevant test (#940) (913b43e)
• update PolicyDocument types (#944) (b1c05b2)

4.1.3 (2019-11-18)

Bug Fixes

• deps: update dependency date-and-time to ^0.11.0 (#934) (c4bf1c6)
• deps: update dependency yargs to v15 (#933) (f40fe0c)

4.1.2 (2019-11-12)

Bug Fixes

• do not check access of configPath (#915) (a21a644)
• missing snippets with jsdoc-region-tag (#924) (310ba90)
• docs: add jsdoc-region-tag plugin (#929) (74526e7)

4.1.1 (2019-11-07)

Bug Fixes

• update format for upload sample (#918) (d77208b)

4.1.0 (2019-10-31)

Features

• [Storage] Support UniformBucketLevelAccess (#903) (35b1bd9)

4.0.1 (2019-10-31)

Bug Fixes

• docs: missing quote in signed url jsdoc (#896) (f2d567f)
• use storage.googleapis.com for api endpoint (862fb16)
• signed-url: replace encodeURIComponent with custom encoding function (#905) (ba41517)

4.0.0 (2019-10-17)

⚠ BREAKING CHANGES

• allow leading slashes in file name (#820)

Bug Fixes

• deps: update hash-stream-validation (#884) (96a7fc2)
• allow leading slashes in file name (#820) (92e115d)

3.5.0 (2019-10-14)

Features

• bucket: add enableLogging method (#876) (b09ecac)

3.4.0 (2019-10-10)

Bug Fixes

• file#move do not delete origin file if same as destination (#874) (dcaba8a)
• pass predefined acl as destinationPredefinedAcl to qs (#872) (09b8fa4)

Features

• add flag to allow disabling auto decompression by client (#850) (9ebface)
• allow setting standard Bucket storage class (#873) (12a99e9)

3.3.1 (2019-09-30)

Bug Fixes

• create correct v4 signed url with cname (#868) (ace3b5e)

3.3.0 (2019-09-19)

Bug Fixes

• deps: update dependency @google-cloud/pubsub to ^0.32.0 (#849) (fdf70bb)
• add warning for unsupported keepAcl param in file#copy (#841) (473bda0)
• remove unsupported keepAcl param (#837) (5f69a3d)
• use storage.googleapis.com for api endpoint (#854) (27fa02f)
• deps: update dependency @google-cloud/pubsub to v1 (#858) (31466f4)
• deps: update dependency date-and-time to ^0.10.0 (#857) (e9ec9cf)

Features

• adds support for asyncIterators (via readable-stream@3 dependency) (dd5ae7f)
• allow removal of resumable upload cache (#773) (da943db), closes #217

3.2.1 (2019-08-28)

Bug Fixes

• docs: stop redirecting reference docs to anchor, add new sample to README (bbb5537)
• samples: fix failing sample view IAM member-role groups (1c4f21f)

3.2.0 (2019-08-22)

Bug Fixes

• deps: update @google-cloud/common with fixes for http (#809) (8598631)
• deps: update dependency @google-cloud/pubsub to ^0.31.0 (#814) (604e564)
• deps: update dependency date-and-time to ^0.9.0 (#805) (8739a7d)
• ts: fix nock @~11.0.0 (#819) (48f9b44)

Features

• hmac service account (#751) (ed1ec7b)

3.1.0 (2019-08-09)

Bug Fixes

• deps: update dependency @google-cloud/paginator to v2 (#781) (23244e9)
• deps: update dependency @google-cloud/pubsub to ^0.30.0 (#778) (7256650)
• allow calls with no request, add JSON proto (30fff15)
• deps: update dependency date-and-time to ^0.8.0 (#779) (ab2734d)
• deps: upgrade @google-cloud/common version to show original… (#795) (ea63cbe)
• deps: use the latest extend (#800) (a7f0172)

Features

• file: allow setting configPath of resumable upload (#642) (a8ceb78)

3.0.4 (2019-07-25)

Bug Fixes

• deps: update dependency pumpify to v2 (#740) (71a4f59)

3.0.3 (2019-07-16)

Bug Fixes

• typescript: make SetLabelOptions optional (#766) (4336882)

3.0.2 (2019-07-01)

Bug Fixes

• docs: fix sample code in docs (#759) (f9e5fd8)
• docs: link to reference docs section on googleapis.dev (#753) (5e3a96b)

3.0.1 (2019-06-14)

Bug Fixes

• async should be dependency (#743) (e542b8b)

3.0.0 (2019-06-14)

⚠ BREAKING CHANGES

• upgrade engines field to >=8.10.0 (#688)

Bug Fixes

• deps: update dependency @google-cloud/common to v1 (#705) (72a9f51)
• deps: update dependency @google-cloud/paginator to v1 (#695) (ada995e)
• deps: update dependency @google-cloud/promisify to v1 (#693) (5df2f83)
• deps: update dependency @google-cloud/pubsub to ^0.29.0 (#714) (3ee1a2c)
• deps: update dependency arrify to v2 (#667) (ce02c27)
• validate action of getSignedUrl() function (#684) (1b09d24)
• deps: update dependency date-and-time to ^0.7.0 (#736) (7071f26)
• deps: update dependency xdg-basedir to v4 (#681) (8b40e6a)
• docs: move to new client docs URL (#738) (a637f99)
• ts: improve return types for response metadata (#666) (da42bed)
• types: fix signatures of listing methods (#703) (42937a8)

Build System

• upgrade engines field to >=8.10.0 (#688) (6a1fa0f)

Features

• add file.isPublic() function (#708) (f86cadb)
• support apiEndpoint override (#728) (61eeb64)

v2.5.0

04-04-2019 12:27 PDT

This release brings an option to file#getSignedURL to create a version 4 Signed URL.

file.getSignedUrl({
  version: 'v4', // optional, defaults to v2 (existing version)
  action: 'read',
  expires: FUTURE_DATE,
})

New Features

• feat: introduce v4 signed url (#637)

Dependencies

• chore(deps): update dependency @types/node to v11.13.0 (#662)
• chore(deps): update dependency @types/tmp to v0.1.0
• chore(deps): upgrade to newest version of @google-cloud/common (#657)
• chore(deps): update dependency typescript to ~3.4.0
• chore(deps): update dependency tmp to ^0.1.0 (#641)

Documentation

• docs: regenerate the samples/README.md (#649)
• docs: slight difference in how nightly synthtool run generated README (#650)
• docs: new synthtool generated README (#645)
• docs(samples): refactor the quickstart to match the new rubric (#647)
• docs: update README format
• docs: add requires_billing, retire .cloud-repo-tools.json (#644)
• docs: add additional api_id field (#640)
• docs: document destination option (#633)
• docs: clarify in docs, the meaning of ASIA and coldline (#632)
• docs: add a .repo-metadata.json (#639)

Internal / Testing Changes

• test(v2-sign): add multi-valued headers system-test (#646)
• refactor: replace once with onetime (#660)
• fix: do not download cached files (#643)
• chore: publish to npm using wombat (#634)
• build: use per-repo npm publish token (#630)

v2.4.3

03-13-2019 17:10 PDT

Bug Fixes / Implementation Changes

• fix: getSigned(Policy|Url) throws if expiration is invalid Date (#614)
• fix: handle errors from file#createReadStream (#615)

Dependencies

• fix(deps): update dependency @google-cloud/paginator to ^0.2.0
• fix(deps): update dependency gcs-resumable-upload to v1 (#619)
• fix(deps): update dependency @google-cloud/pubsub to ^0.27.0 (#620)
• fix(deps): update dependency @google-cloud/pubsub to ^0.26.0 (#618)
• fix(deps): update dependency @google-cloud/pubsub to ^0.25.0 (#616)
• chore(deps): update dependency mocha to v6 (#611)
• fix(deps): update dependency @google-cloud/promisify to ^0.4.0 (#609)
• chore(deps): update dependency @types/tmp to v0.0.34 (#608)
• fix(deps): update dependency yargs to v13 (#606)

Documentation

• docs: update links in contrib guide (#610)
• docs: update contributing path in README (#603)
• chore: move CONTRIBUTING.md to root (#601)

Internal / Testing Changes

• build: Add docuploader credentials to node publish jobs (#624)
• build: use node10 to run samples-test, system-test etc (#623)
• build: update release configuration
• build: use linkinator for docs test (#607)
• build: create docs test npm scripts (#605)
• build: test using @grpc/grpc-js in CI (#604)
• chore: remove console.log in system test (#599)

v2.4.2

02-05-2019 16:55 PST

Dependencies

• deps: update @google-cloud/common (#596)
• chore(deps): update dependency typescript to ~3.3.0 (#591)

Documentation

• docs: add lint/fix example to contributing guide (#594)

Internal / Testing Changes

• test: skip public bucket system tests running under VPCSC (#595)

v2.4.1

01-29-2019 13:05 PST

Implementation Changes

• fix(ts): fix Storage.createBucket overloaded signature (#589)

Dependencies

• fix(deps): update dependency @google-cloud/pubsub to ^0.24.0 (#588)

v2.4.0

01-28-2019 12:13 PST

New Features

• fix: expires can be a Date, string, or number (#548)

Dependencies

• deps: upgrade nodejs-common (#582)
• chore(deps): update dependency eslint-config-prettier to v4 (#586)
• fix(deps): update dependency @google-cloud/pubsub to ^0.23.0 (#583)
• fix(deps): update dependency concat-stream to v2 (#563)

Documentation

• docs(samples): Bucket Policy Only Samples (#557)
• fix(docs): move jsdoc away from interface (#565)

Internal / Testing Changes

• test: Bucket Policy Only related system test (#579)
• build: check broken links in generated docs (#567)
• build: include only build/src in compiled source (#572)

v2.3.4

12-19-2018 14:21 PST

Implementation Changes

• fix(types): file.getMetadata should resolves to Metadata, not File (#560)

Internal / Testing Changes

• refactor: modernize the sample tests (#558)
• chore(build): inject yoshi automation key (#555)
• chore: update nyc and eslint configs (#554)
• chore: fix publish.sh permission +x (#552)
• fix(build): fix Kokoro release script (#551)
• build: add Kokoro configs for autorelease (#550)

v2.3.3

12-06-2018 17:09 PST

Dependencies

• chore(deps): update dependency @types/configstore to v4 (#537)
• chore(deps): update dependency @google-cloud/pubsub to ^0.22.0 (#535)

Documentation

• fix(docs): place doc comment above the last overload (#544)
• docs: update readme badges (#536)

Internal / Testing Changes

• chore: always nyc report before calling codecov (#543)
• chore: nyc ignore build/test by default (#542)
• chore: update license file (#539)

v2.3.2

This patch release fixed an issue affecting reading from a file on GCS (#528).

Dependencies

• fix(dep): upgrade teeny-request to v3.11.3 (#529)
• fix(deps): update dependency @google-cloud/common to ^0.27.0 (#525)

Internal / Testing Changes

• refactor: convert sample tests from ava to mocha (#523)
• docs(samples): updated samples code to use async await (#521)
• chore: add synth.metadata
• fix(ts): Update bucket options types (#518)

v2.3.1

11-14-2018 22:15 PST

Bug fixes

• fix: fix TypeScript and system tests (#515)
• fix(deps): update dependency through2 to v3 (#507)
• docs: File#setMetadata in parallel results in unpredictable state (#504)

Internal / Testing Changes

• chore(deps): update dependency gts to ^0.9.0 (#514)
• chore: update eslintignore config (#513)
• chore(deps): update dependency @google-cloud/nodejs-repo-tools to v3 (#512)
• refactor: use object.assign where possible (#510)
• chore: drop contributors from multiple places (#511)
• chore: use latest npm on Windows (#509)

v2.3.0

Implementation Changes

• fix(types): Fixes getSignedUrl Return Type (#496)

New Features

• Introduce Object Lifecycle Management (#471)

Dependencies

• chore(deps): update dependency eslint-plugin-node to v8 (#490)

Internal / Testing Changes

• chore: update issue templates (#488)

v2.2.0

Bug Fixes

• fix: re-enable typescript types (#484)

Dependencies

• fix(deps): update dependency @google-cloud/common to ^0.26.0 (edited) (#480)
• chore: Remove 'is' dependency (#462)
• chore: upgrade teeny-request to 3.11.0 with type definitions (#457)
• feat: use small HTTP dependency (#416)

Documentation

• docs: Minor docs correction (#465)

Internal / Testing Changes

• chore: remove old issue template (#485)
• chore(typescript): enable noImplicitAny (#483)
• chore(typescript): improve typescript types and update tests (#482)
• build: run tests on node11 (#481)
• chores(build): do not collect sponge.xml from windows builds (#478)
• chores(build): run codecov on continuous builds (#476)
• chore: update new issue template (#475)
• fix: enable noImplicitAny for src/bucket.ts (#472)
• fix(tests): use unique prefix for system tests to avoid collision with another run (#468)
• fix: improve the types (#467)
• chore: move class Storage to storage.ts, create index.ts that contains all exports (#464)
• chore: add types to many unit tests (#463)
• fix: Annotate Iam types (#461)
• fix: complete bucket.ts noImplicitAny (#460)
• fix: improve the types on acl.ts (#459)
• fix: improve types (7) (#458)
• fix: improve the types (#453)
• chore: update build config (#455)
• fix: improve typescript types in src/file.ts (#450)
• build: fix codecov uploading on Kokoro (#451)
• test: Attempt to re-enable iam#testPermissions (#429)
• chore(deps): update dependency sinon to v7 (#449)
• Re-generate library using /synth.py (#448)
• Correct parameter name. (#446)

v2.1.0

This release brings support for Bucket/Object lock operations, as well as disable TypeScript as we continue to annotate the project with types.

New Features

• feat: Support Bucket/Object lock operations (#374)

Implementation Changes

• disable types for now (#392)
• Don't publish sourcemaps (#412)

TypeScript support (in progress)

• fix: add better types for file.ts (#436)
• fix: use ~ for typescript (and fix compile errors) (#426)
• fix: Add typing for File#download() (#409)
• chore: convert system tests to typescript (#424)
• Improve TypeScript types (part 4) (#402)
• ts: convert jsdoc types to typescript interfaces (1) (#383)
• fix: TS definition (#387)
• Annotate types #3 (#391)
• Annotate types (2) (#388)

Dependencies

• chore(deps): update dependency eslint-plugin-prettier to v3 (#419)

Documentation

• docs: Modify source location for templates (#410)
• docs: Explain Bucket#upload() still exists (#421)

Internal / Testing Changes

• fix(tests): fix system tests on CircleCI (#431)
• fix(tests): system-test compiles to ./build, fix relative path (#428)
• Update kokoro config (#425)
• chore(samples): convert samples to async/await (#422)
• build: samples test by adding approprate test variables (#423)
• build: bring in latest kokoro cfgs to run System tests on PRs (#413)
• test: remove appveyor config (#411)
• Enable prefer-const in the eslint config (#404)
• fix(test): instantiate PubSub using new (#403)
• fix: optionsOrCallback could be undefined if not given, check before assign (#401)
• Fix the requesterPays methods (#400)
• Enable no-var in eslint (#398)
• samples: don't use USA formatted dates for expiry (#396)
• fix: copy(): Use correct destination file name in URI (#389)

v2.0.3

Implementation Changes

• Improve TypeScript types (#381)
• Make some parameters optional (#380)

v2.0.2

Implementation Changes

• Improve the types (#377)

v2.0.1

This fixes types declaration issues with projects using TypeScript.

Implementation Changes

• Enable noImplicitThis in the tsconfig (#370)
• Fix the path to the d.ts (#364)
• fix: make dependency on request explicit (#361)
• fix: remove trailing slashes from bucket name. (#266)

Dependencies

• fix(deps): update dependency @google-cloud/common to ^0.24.0 (#367)
• fix(deps): update dependency gcs-resumable-upload to ^0.13.0 (#368)
• Remove unused dependencies (#363)
• Remove safe-buffer (#359)
• samples: update dependency @google-cloud/storage to v2 (#350)

Internal / Testing Changes

• Update CI config (#371)
• build(kokoro): run docker as user node (#358)
• build: fix multiline in circle.yml (#357)
• fix executable modes on .sh's; add pre-system-test.sh hook (#356)
• decrypt both service account keys (#353)
• Retry npm install in CI (#352)
• Add synth script and run it (#351)

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)