Changelog

3.21.0 (2024-04-26)

Features

Bug Fixes

  • deps: Update the Java code generator (gapic-generator-java) to 2.39.0 (#1629) (4964982)

Documentation

  • Allow 14 week backup retention for Firestore daily backups (4964982)
  • Correct BackupSchedule recurrence docs that mentioned specific time of day (4964982)

3.20.2 (2024-04-19)

Dependencies

  • Update dependency com.google.cloud:sdk-platform-java-config to v3.29.0 (#1652) (1e3b0b9)

3.20.1 (2024-04-18)

Dependencies

3.20.0 (2024-03-26)

Features

Dependencies

3.19.3 (2024-03-21)

Dependencies

  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1625) (f390946)

3.19.2 (2024-03-18)

Dependencies

  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1617) (44d5e8d)

3.19.1 (2024-03-15)

Dependencies

  • Update dependency com.google.cloud:sdk-platform-java-config to v3.28.0 (#1612) (06fa74e)

3.19.0 (2024-03-15)

Features

  • A new message Backup is added (#1611) (434a55b)
  • Add ExplainMetrics field to RunAggregationQueryResponse (f275b16)
  • Add ExplainMetrics field to RunQueryResponse (f275b16)
  • Add ExplainOptions field to RunAggregationQueryRequest (f275b16)
  • Add ExplainOptions field to RunQueryRequest (f275b16)
  • Add new types ExplainOptions, ExplainMetrics, PlanSummary, ExecutionStats (#1608) (f275b16)

Bug Fixes

3.18.0 (2024-03-04)

Features

Bug Fixes

  • deps: Update the Java code generator (gapic-generator-java) to 2.37.0 (#1597) (7574dfd)
  • Only override built-in retry settings when the customer provides them. (#1588) (103c37a)

Dependencies

  • Update dependency com.google.cloud:sdk-platform-java-config to v3.27.0 (#1596) (2672d71)

3.17.1 (2024-02-22)

Dependencies

  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.10.1 (#1576) (f45af23)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.1 (#1577) (396d06b)

3.17.0 (2024-02-15)

Features

  • Add an API method for reordering firewall policies (#1572) (60d8ab1)

Bug Fixes

  • Transactions with readTime will omit begin and commit transaction requests, and instead pass readTime on individual read requests. (#1565) (d5fb01a)

Dependencies

  • Update beam.version to v2.54.0 (#1571) (e0d4daa)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.25.0 (#1567) (b6c1531)

3.16.3 (2024-02-05)

Dependencies

  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.2 (#1559) (502cf05)

3.16.2 (2024-02-01)

Bug Fixes

  • Remove QueryMode field from RunAggregationQueryRequest (32b539c)
  • Remove QueryMode field from RunQueryRequest (32b539c)
  • Remove ResultSetStats field from RunAggregationQueryResponse (32b539c)
  • Remove ResultSetStats field from RunQueryResponse (32b539c)
  • Remove types QueryMode, QueryPlan, ResultSetStats (32b539c)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.24.0 (#1551) (6874143)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.10.0 (#1553) (701d820)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.0 (#1554) (581da1f)

3.16.1 (2024-01-25)

Bug Fixes

  • internalStream should handle duplicate onCompletes. (#1523) (b3067d7)
  • Allow an explicit MustExist precondition for update (#1542) (46e09aa)
  • deps: Update the Java code generator (gapic-generator-java) to 2.32.0 (#1534) (2281320)
  • Make rollback best effort. (#1515) (4c39af5)
  • Thread safe UpdateBuilder (#1537) (f9cdab5)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.22.0 (#1535) (04c0e07)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.23.0 (#1544) (79713bf)

Documentation

3.16.0 (2024-01-10)

Features

  • Add DeleteDatabase API and delete protection (#1508) (81a1b48)
  • Add new types QueryMode, QueryPlan, ResultSetStats (#1516) (3060e86)
  • Expose Firestore namespace ID fields in import/export APIs to stable (21ad25f)
  • Expose Firestore PITR fields in Database to stable (#1495) (21ad25f)
  • Expose Firestore snapshot_time field in export API to stable (21ad25f)
  • Logical termination for firestore.getAll(...). (#1517) (c6448fc)

Bug Fixes

  • Better error message when Transaction/WriteBatch is modified after commit. (#1503) (9693c7b)
  • deps: Update the Java code generator (gapic-generator-java) to 2.31.0 (#1520) (c4c5a0b)

Dependencies

  • Update beam.version to v2.53.0 (#1514) (7639e0d)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.21.0 (#1518) (866b2b4)

Documentation

3.15.7 (2023-12-01)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.20.0 (#1490) (73a85e7)

3.15.6 (2023-11-22)

Dependencies

  • Update beam.version to v2.52.0 (#1480) (45e33f7)
  • Update dependency org.apache.commons:commons-lang3 to v3.14.0 (#1482) (3ef71f8)

3.15.5 (2023-11-14)

Bug Fixes

  • Prevent watch stream from emitting events after close. (#1471) (ee3f8c0)

Dependencies

  • Update actions/github-script action to v7 (#1473) (1097a0b)
  • Update actions/github-script action to v7 (#1475) (d848d87)

3.15.4 (2023-11-07)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.19.0 (#1467) (a048707)

3.15.3 (2023-11-06)

Dependencies

  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.1 (#1463) (6180322)

3.15.2 (2023-10-20)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.18.0 (#1450) (d32d343)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.28 (#1451) (a008a69)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.28 (#1452) (59daefe)

3.15.1 (2023-10-11)

Dependencies

  • Update dependency org.apache.beam:beam-runners-direct-java to v2.51.0 (#1443) (738f93a)

3.15.0 (2023-10-10)

Features

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.17.0 (#1437) (cd006f9)

3.14.4 (2023-09-28)

Bug Fixes

  • Add tests for multiple inequality support (#1392) (e01b3a1)

Dependencies

  • Remove unused dependency that is blocking PR 1428 (#1429) (73ff8dc)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.16.1 (#1431) (38832f9)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.27 (#1425) (dc26bbb)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.27 (#1426) (5e8b299)

3.14.3 (2023-09-12)

Bug Fixes

  • Add reflections configs for generated firestore classes (#1419) (1c5e09f)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.15.0 (#1417) (3626776)

3.14.2 (2023-09-07)

Dependencies

  • Update beam.version to v2.50.0 (#1410) (fa14cad)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.26 (#1413) (501af1a)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.26 (#1414) (afb93d2)

3.14.1 (2023-08-25)

Dependencies

  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.25 (#1405) (01720e5)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.25 (#1406) (438ad97)

3.14.0 (2023-08-08)

Features

  • Publish proto definitions for SUM/AVG in Firestore (#1304) (b025d11)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.14.0 (#1385) (d215982)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.24 (#1388) (24be02b)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.24 (#1389) (34e30e0)

3.13.8 (2023-07-28)

Dependencies

  • Update dependency org.apache.commons:commons-lang3 to v3.13.0 (#1380) (f6f07fb)

3.13.7 (2023-07-27)

Dependencies

3.13.6 (2023-07-24)

Dependencies

  • Update dependency org.junit.vintage:junit-vintage-engine to v5.10.0 (#1368) (188a8e9)

3.13.5 (2023-07-20)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.1 (#1364) (7dde6ee)

3.13.4 (2023-07-20)

Bug Fixes

  • Remove 'x-goog-request-params' header from GRPC requests due to incorrect format. (#1358) (1a1bf5f)

3.13.3 (2023-07-13)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.0 (#1351) (7c11f8a)

3.13.2 (2023-06-22)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.12.0 (#1338) (0ef1882)

3.13.1 (2023-06-21)

Dependencies

  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.23 (#1329) (ea5e78f)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.23 (#1330) (63a01e6)

3.13.0 (2023-06-12)

Features

  • Add toString methods to classes comprising WriteBatch (#1281) (9df8028)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.11.0 (#1322) (c2bca72)

3.12.1 (2023-06-05)

Dependencies

3.12.0 (2023-05-30)

Features

  • Add ApiScope and COLLECTION_RECURSIVE query_scope for Firestore index (#1300) (b84a7cd)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.10.1 (#1305) (b734212)

3.11.0 (2023-05-12)

Features

Dependencies

  • Update beam.version to v2.47.0 (#1292) (e9f11e8)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.9.0 (#1291) (6dd0e8f)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.22 (#1293) (e8e5f9b)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.22 (#1294) (f0ceb7f)

3.10.0 (2023-04-27)

Features

  • Add bloom filter related proto fields (only in the preview API surface) (#1274) (41909b7)

3.9.6 (2023-04-26)

Dependencies

  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.3 (#1275) (1f32893)

3.9.5 (2023-04-25)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.8.0 (#1268) (8a92dc9)

3.9.4 (2023-04-12)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.7.0 (#1257) (52db039)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.21 (#1258) (12bcf02)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.21 (#1259) (19b5da2)

3.9.3 (2023-03-29)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.6.0 (#1247) (aa098e0)

3.9.2 (2023-03-20)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.5.0 (#1239) (61b1439)

3.9.1 (2023-03-15)

Dependencies

3.9.0 (2023-03-06)

Features

3.8.2 (2023-03-02)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.4.0 (#1219) (fe84125)

3.8.1 (2023-02-17)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.3.0 (#1206) (a118ce0)

3.8.0 (2023-02-15)

Features

Dependencies

  • Update beam.version to v2.45.0 (#1201) (196a75d)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.20 (#1196) (51fe67c)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.20 (#1197) (a66b8b4)

3.7.10 (2023-02-06)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.2.0 (#1185) (42c34da)

3.7.9 (2023-01-27)

Bug Fixes

  • java: Fix error message returned for invalid snapshot listener inequality filter (#1093) (bf7f4a3)
  • java: Skip fixing poms for special modules (#1744) (#1172) (222be48)

3.7.8 (2023-01-20)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.2 (#1174) (187a9be)

3.7.7 (2023-01-18)

Dependencies

3.7.6 (2023-01-13)

Dependencies

  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.2 (#1158) (418b2bf)

3.7.5 (2023-01-13)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.1 (#1157) (c7c688b)

3.7.4 (2022-12-08)

Dependencies

3.7.3 (2022-11-21)

Dependencies

  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.18 (#1132) (6b57290)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.18 (#1133) (8cb45ae)

3.7.2 (2022-11-18)

Dependencies

3.7.1 (2022-11-08)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.6 (#1092) (019840f)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.17 (#1087) (a78be32)

3.7.0 (2022-10-22)

Features

Bug Fixes

Dependencies

  • Update beam.version to v2.42.0 (#1066) (03de01a)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.5 (#1071) (4c3f122)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.16 (#1064) (a7ddc9e)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.15 (#1065) (d9e7803)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.16 (#1069) (97ef50a)

3.6.0 (2022-10-04)

Features

  • Count queries (not available for use yet) (#1033) (8b60612)
  • Make count queries publicly available for use (#1042) (1c8d242)

Documentation

  • AggregateQuery.java: describe why we ignore subsequent responses (#1041) (8150544)

Dependencies

  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.4 (#1053) (9b4c26e)
  • Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.14 (#1045) (04b3861)
  • Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.14 (#1046) (6631a58)
  • Update dependency org.junit.vintage:junit-vintage-engine to v5.9.1 (#1039) (84423f4)

3.5.0 (2022-09-16)

Features

  • Add firestore aggregation query apis to the stable googleapis branch (#1030) (0e3e2ac)

Dependencies

  • Update actions/setup-java action to v3 (#1031) (1aae546)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.2 (#1032) (9b68360)
  • Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.3 (#1034) (5acd8e4)

3.4.2 (2022-08-24)

Dependencies

3.4.1 (2022-08-19)

Bug Fixes

  • declare gson as runtime rather than test (#1004) (e37e997)

3.4.0 (2022-08-03)

Features

Bug Fixes

  • update gapic-generator-java with mock service generation fixes (#960) (a9338ff)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v3 (#1000) (a3c4ec5)
  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.12 (#972) (8cf33b0)
  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.13 (#988) (f8d9496)
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.13 (#989) (4c768e3)
  • update dependency org.junit.vintage:junit-vintage-engine to v5.9.0 (#997) (d4dd4d8)

3.3.0 (2022-07-01)

Features

  • add logical termination for RunQueryResponse (#956) (1d869c8)

Bug Fixes

  • add build script for JDK 17 native image testing (#965) (963e384)

Performance Improvements

  • Change how proto was called in Query.java (#970) (f6f6352)

Dependencies

  • update beam.version to v2.40.0 (#978) (44276f8)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.13.0 (#974) (6def73d)
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.12 (#973) (bfb4ec9)

3.2.0 (2022-05-23)

Features

Documentation

  • sample: remove unused native-image-support module (#952) (17c2de9)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.12.0 (#959) (f1d6b17)

3.1.0 (2022-04-21)

Features

  • relocate Firestore native image configuration from java-core (#941) (900a7a8)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.10.0 (#945) (5b2e318)
  • update dependency com.google.cloud:native-image-support to v0.13.1 (#944) (b3b474f)

3.0.21 (2022-03-30)

Bug Fixes

  • change REST binding for ListDocuments to support root collection (#900) (aabd4ac)
  • java: move test native image configs to test/resources (#929) (9ed6c5e)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.9.0 (#932) (abebae7)
  • update dependency com.google.cloud:native-image-support to v0.12.11 (#931) (0e1e3c5)

3.0.20 (2022-03-24)

Dependencies

  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.11 (#923) (43f24b1)
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.11 (#924) (70b0d00)

3.0.19 (2022-03-14)

Bug Fixes

  • java: fix native image Kokoro test setup (#919) (7d905a5)

Dependencies

  • update dependency com.google.cloud:native-image-support to v0.12.10 (#917) (0a650e0)

3.0.18 (2022-03-10)

Dependencies

  • update dependency com.google.cloud:native-image-support to v0.12.9 (#912) (fedf824)

3.0.17 (2022-03-09)

Dependencies

  • update dependency com.google.cloud:native-image-support to v0.12.8 (#909) (2580d8f)

3.0.16 (2022-03-08)

Dependencies

  • update dependency com.google.cloud:native-image-support to v0.12.7 (#902) (843dd0e)

3.0.15 (2022-03-02)

Documentation

  • sample: Use Java 8 for native image sample (#893) (5955f54)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.8.0 (#895) (bf1951d)
  • update dependency com.google.cloud:native-image-support to v0.12.6 (#898) (73606e5)

3.0.14 (2022-03-01)

Bug Fixes

  • fix groupID for artifacts (#890) (bb46bcb)
  • java: add reflection configuration for native image tests (#878) (1938113)

Dependencies

  • update actions/setup-java action to v3 (#888) (07130f9)
  • update dependency com.google.cloud:native-image-support to v0.12.5 (#889) (5f4ffcb)
  • update dependency org.graalvm.buildtools:junit-platform-native to v0.9.10 (#880) (a3a9684)

3.0.13 (2022-02-22)

Bug Fixes

Documentation

  • sample: Add sample for native image support in Firestore (#872) (a01fe88)

Dependencies

  • update dependency com.google.cloud:native-image-support to v0.12.4 (#882) (b2aeb1a)
  • update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.10 (#881) (036f7f8)

3.0.12 (2022-02-04)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.7.0 (#860) (bf48381)
  • update dependency org.apache.commons:commons-lang3 to v3.12.0 (#846) (efc73bd)

3.0.11 (2022-01-27)

Bug Fixes

  • close the Watch stream when we receive an error (#834) (077c9be)

3.0.10 (2022-01-07)

Bug Fixes

  • java: add -ntp flag to native image testing command (#829) (a0fb54f)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.6.0 (#841) (ea34d81)

3.0.9 (2021-12-03)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.5.1 (#825) (1b8e3a3)

3.0.8 (2021-11-16)

Bug Fixes

  • respect total request timeout for Query retries (#806) (feb1921)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.5.0 (#814) (c1f4dac)

3.0.7 (2021-10-27)

Bug Fixes

  • java: java 17 dependency arguments (#802) (ec07294)
  • set timeouts for BatchGetDocuments/RunQuery (#799) (6cd2a45)

3.0.6 (2021-10-19)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.4.0 (#793) (1af36a9)

3.0.5 (2021-09-22)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.3.0 (#775) (35469d6)

3.0.4 (2021-09-14)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.1 (#765) (e7a6537)

3.0.3 (2021-08-31)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.0 (#753) (6744bfa)
  • update google-cloud-conformance-tests to 0.2.0 (#752) (135bc6b)

3.0.2 (2021-08-23)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.1.0 (#739) (99b5820)

3.0.1 (2021-08-11)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v2.0.1 (#728) (167683d)

3.0.0 (2021-08-09)

⚠ BREAKING CHANGES

  • update Java compile to 1.8 (#710)
  • update gapic generator to 2.0.0, java 8 features (#719)

Features

  • update Java compile to 1.8 (#710)
  • gapic-generator-java v1.0.13, mtls support (#712) (a27dd9c)
  • update gapic generator to 2.0.0, java 8 features (#719) (0d5b378)

Dependencies

2.6.2 (2021-07-29)

Bug Fixes

  • Add shopt -s nullglob to dependencies script (8f4b199)
  • Ensures bundles are encoded as UTF8 bytes. (#695) (0946a17)
  • lower batch size on BulkWriter retry (#688) (146b21d)
  • Update dependencies.sh to not break on mac (#694) (8f4b199)

Documentation

  • began merging variant client samples (#696) (0a10dd8)

2.6.1 (2021-06-30)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v1.4.0 (#680) (b8ffcb4)

2.6.0 (2021-06-29)

Features

Bug Fixes

  • handle thrown exceptions in runAsyncTransaction callback (#671) (969f7fd)

2.5.1 (2021-06-22)

Bug Fixes

  • return results from getPartitions() in order (#653) (12d17d1)

Dependencies

  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.1.1 (#650) (b93ca8a)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v1.3.0 (#660) (0f13fd0)

2.5.0 (2021-06-01)

Features

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v1.2.0 (#640) (9bd881a)

2.4.0 (2021-05-17)

Features

Bug Fixes

  • add flush check in BulkWriter.sendBatchLocked() callback (#631) (ac3db81)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v1.1.0 (#626) (00dbe33)

2.3.0 (2021-04-23)

Features

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v1 (#607) (21e8cde)

2.2.7 (2021-04-20)

Bug Fixes

  • release scripts from issuing overlapping phases (#595) (4372479)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.1 (#597) (dbd3d33)

2.2.6 (2021-04-13)

Bug Fixes

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.0 (#584) (c83a222)

2.2.5 (2021-03-11)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.1 (#567) (7370d21)

2.2.4 (2021-02-25)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.0 (#554) (0ae4ea3)

2.2.3 (2021-02-19)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.19.0 (#543) (7eed88c)

2.2.2 (2021-02-19)

Bug Fixes

  • block close() on the termination of all RPC channels (#512) (67bd06a)
  • samples: close firestore instance in test (#476) (fb1cb17)

2.2.1 (2021-02-02)

Bug Fixes

  • don't throw NPE in DocumentSnapshot.getDate() when value is missing (#513) (a41b07e)

2.2.0 (2021-01-20)

Features

  • Add bundle proto building (#271) (994835c)
  • add bundle.proto from googleapis/googleapis (#407) (37da386)
  • add CollectionGroup#getPartitions(long) (#478) (bab064e)
  • add implicit ordering for startAt(DocumentReference) calls (#417) (aae6dc9)
  • add max/min throttling options to BulkWriterOptions (#400) (27a9397)
  • add success and error callbacks to BulkWriter (#483) (3c05037)
  • Implementation of Firestore Bundle Builder (#293) (fd5ef90)
  • Release bundles (#466) (3af065e)

Bug Fixes

  • add @BetaApi, make BulkWriter public, and refactor Executor (#497) (27ff9f6)
  • build: sample checkstyle violations (#457) (777ecab)
  • bulkWriter: writing to the same doc doesn't create a new batch (#394) (259ece8)
  • empty commit to trigger release-please (fcef0d3)
  • make BulkWriterOptions public (#502) (6ea05be)
  • retry Query streams (#426) (3513cd3)
  • retry transactions that fail with expired transaction IDs (#447) (5905438)
  • verify partition count before invoking GetPartition RPC (#418) (2054ae9)

Documentation

  • sample: normalize firestore sample's region tags (#453) (b529245)

Dependencies

  • remove explicit version for jackson (#479) (e2aecfe)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.12 (#367) (2bdd846)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.13 (#411) (e6157b5)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.0 (#383) (cb39ee8)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.2 (#403) (991dd81)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.12.1 (#425) (b897ffa)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.13.0 (#430) (0f8f218)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.14.1 (#446) (e241f8e)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.15.0 (#460) (b82fc35)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.0 (#481) (ae98824)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.1 (4ace93c)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.17.0 (#487) (e11e472)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.18.0 (#495) (f78720a)
  • update jackson dependencies to v2.11.3 (#396) (2e176e2)

2.1.0 (2020-09-10)

Features

  • add method to set emulator host programmatically (#319) (#336) (97037f4), closes #210 #190
  • add opencensus tracing support (#360) (edaa539)
  • add support for != and NOT_IN queries (#350) (68aff5b)
  • generate protos to add NOT_EQUAL, NOT_IN, IS_NOT_NAN, IS_NOT_NULL query operators (#343) (3fb1b63)

Bug Fixes

  • samples: re-add maven exec config for Quickstart sample (#347) (4c2329b)
  • add support to deserialize to custom Lists and Maps (#337) (dc897e0)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.9.0 (#352) (783d41e)

2.0.0 (2020-08-14)

New Features

Query Partition API

New API and backend RPC which allows for fetching a set of cursor keys for a Collection Group Query. Accessible via the new CollectionGroup#getPartitions(long,ApiStreamObserver) method.

Read-Only Transaction Options

TransactionOptions has been refactored to provide the ability to configure options for read-only transactions along with the existing configuration for read-write transactions.

This new ability is provided via the new TransactionOptions.createReadOnlyOptionsBuilder() type safe builder.

Along with the new type safe builder for read-only options, there is a new type safe builder for read-write options as well accessible via TransactionOptions.createReadWriteOptionsBuilder(). Each of the existing TransactionOptions.create(...) methods for configuring read-write options has been deprecated in favor of the new builder.

EmulatorCredentials

com.google.cloud.firestore.FirestoreOptions.Builder.FakeCredentials has been made static and renamed to com.google.cloud.firestore.FirestoreOptions.EmulatorCredentials allowing instantiation outside FirestoreOptions.Builder.

When connecting to the Cloud Firestore Emulator via FirestoreOptions rather than the environment variable FIRESTORE_EMULATOR_HOST, a custom credential implementation must be specified to allow various admin operations in the emulator. Previously this required users to create their own implementation due to it not being possible to construct a FakeCredential. As part of this change, EmulatorCredentials is static and therefore able to be constructed from any location.

Breaking Changes

New Firestore Admin Client API Artifact

The Cloud Firestore Admin Client has been migrated to its own maven artifact com.google.cloud:google-cloud-firestore-admin rather than being bundled in com.google.cloud:google-cloud-firestore. All packages and classes have retained their existing names.

The new artifact is included in the com.google.cloud:google-cloud-firestore-bom, com.google.cloud:google-cloud-bom and com.google.cloud:libraries-bom artifacts and is accessible by adding the new dependency to your pom.xml file:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-firestore-admin</artifactId>
</dependency>

Removal of v1beta1

Cloud Firestore has been GA for some time now, and the google-cloud-firestore code base has been using the protos and generated classes for the v1 api since that time. As such, we will no longer be publishing artifacts for the deprecated v1beta1 protos. All functionality from v1beta1 is present in v1, and all users should update any code to use v1.

Removal of support for java.util.Date in Snapshots

It is no longer possible to configure the ability for java.util.Date to be returned from DocumentSnapshot.get(FieldPath) or DocumentSnapshot.getData() for properties which are stored as Timestamps in Cloud Firestore.

The default behavior has been to return com.google.cloud.Timestamp by default for some time, and is now the only option. Any code that is dependent on the old behavior must be updated to use Timestamps instead of Date.

Laundry List of Pull Requests

⚠ BREAKING CHANGES

  • add support for the Query Partition API (#202)
    • Firestore#collectionGroup(...) has a new return type CollectionGroup which requires any code that previously used the method be re-compiled to pick up the new signature. CollectionGroup extends Query and as such does not require your code to be updated, only the compiled class files.
  • move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (#311)
  • remove deprecated v1beta1 protos and grpc client (#305)
  • remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308)
  • remove deprecated getCollections() methods (#307)
  • various renames due to generator changes

Features

  • add support for read-only transactions in TransactionOptions (#320) (c25dca3)
  • add support for the Query Partition API (#202) (3996548)

Bug Fixes

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.5 (#322) (1b21350)
  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.6 (#324) (b945fdb)
  • update jackson dependencies to v2.11.2 (#314) (15d68cd)

Miscellaneous Chores

  • enable gapicv2 (#188) (92224bc)
  • move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (#311) (03ef755)
  • remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308) (7255a42)
  • remove deprecated getCollections() methods (#307) (bb4ddf1)
  • remove deprecated v1beta1 protos and grpc client (#305) (96adacb)
  • add BulkWriter (#323) (e7054df)
  • make BulkWriter package private (#330) (ef0869a)

1.35.2 (2020-07-16)

Bug Fixes

  • add Internal#autoId() (#292) (b91c57c)
  • add support for deleting nested fields that contain periods (#295) (84f602e)
  • use test credentials when connecting to the Emulator from the Firebase Admin SDK (#296) (a0a6e80)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.3 (#289) (2ddb8f1)

1.35.1 (2020-07-01)

Dependencies

  • update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.2 (#280) (9296f7a)
  • update jackson dependencies to v2.11.1 (#272) (1065704)
  • adopt flatten plugin and google-cloud-shared-dependencies (#261) (78b2ebf)

1.35.0 (2020-06-17)

Features

  • ability to serialize Query to Proto (#241) (bae22e0)
  • add support for fieldmask to document reference (#245) (4a846b1)

Dependencies

  • update core dependencies (#254) (9b275ca)
  • update dependency com.google.api:api-common to v1.9.2 (#238) (c47d327)
  • update dependency io.grpc:grpc-bom to v1.30.0 (#244) (b5749d4)

1.34.0 (2020-05-29)

Features

Bug Fixes

  • add RateLimiter (#230) (47d4a11)
  • catch null Firestore in system tests (#215) (2a4a7b5)
  • Fields used in whereIn should be equality filters (#216) (4a62633)
  • replace usages of transform proto with update_transform (#213) (46a3c51)
  • support array of references for IN queries (#211) (b376003)

Dependencies

  • update core dependencies to v1.93.5 (#229) (b078213)
  • update dependency com.google.api:api-common to v1.9.1 (#228) (7e4568d)
  • update dependency com.google.api.grpc:proto-google-common-protos to v1.18.0 (#204) (1e05de4)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.10 (#197) (69372af)
  • update dependency com.google.guava:guava-bom to v29 (#180) (3c204b4)
  • update dependency io.grpc:grpc-bom to v1.29.0 (#206) (5d8c50f)
  • update dependency org.threeten:threetenbp to v1.4.4 (#194) (c867bd5)
  • update jackson dependencies to v2.11.0 (#195) (5066812)
  • update protobuf.version to v3.12.0 (#220) (2c0b35d)
  • update protobuf.version to v3.12.2 (#226) (2eeea19)

Documentation

  • update README to include code formatting (#209) (04f8b3b)

1.33.0 (2020-04-08)

Features

  • add new Firestore.runAsyncTransaction (#103) (b28b660)
    • NOTICE This change will require any users of the library that implement com.google.cloud.firestore.Firestore to have to implement the new runAsyncTransaction methods, and is a binary incompatible change in Java 7. Those users who only use com.google.cloud.firestore.Firestore through the instance returned from FirestoreOptions.getDefaultInstance().getService() will not have to recompile their code.
  • add Query.limitToLast() (#151) (c104615)
  • base transaction retries on error codes (#129) (00b6eb3), closes googleapis/nodejs-firestore#953
  • use SecureRandom instead of Random to reduce the chance of auto-id collisions (#156) (0088ee7)

Bug Fixes

  • add missing @InternalExtensionOnly annotation to com.google.cloud.firestore.Firestore (#141) (d3458cb)
  • add support for updating an individual field with pojo in all update method (#136) (7d6c2c1)
  • mark v1beta1 as deprecated (#154) (495f7f9)

Dependencies

  • update core dependencies (#127) (7995db0)
  • update core dependencies (#167) (11f16fd)
  • update core dependencies to v1.55.0 (#158) (f3a20d3)
  • update core dependencies to v1.93.3 (#132) (50394e1)
  • update core dependencies to v1.93.4 (#168) (2118232)
  • update dependency com.google.api:api-common to v1.9.0 (#153) (8ca0ea8)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.8 (#123) (0bbf4b0)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.9 (#152) (d41c41f)
  • update dependency com.google.cloud.samples:shared-configuration to v1.0.13 (#148) (6bd8e7f)
  • update dependency org.threeten:threetenbp to v1.4.2 (#142) (41b2a9a)
  • update dependency org.threeten:threetenbp to v1.4.3 (#165) (d8bfa80)

1.32.5 (2020-03-05)

Bug Fixes

Dependencies

  • update core dependencies (#120) (293ba55)
  • update core dependencies to v1.93.1 (#124) (6ce14ce)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.6 (#118) (7dad920)
  • update dependency io.grpc:grpc-bom to v1.27.2 (#116) (83ef310)
  • update jackson dependencies to v2.10.3 (#122) (85a3ced)

1.32.4 (2020-02-18)

Bug Fixes

  • add cause to transaction errors on transaction commit (#108) (00b3c6f)
  • remove error_prone_annotations exclusion rules from poms (#97) (0f9b474)

Dependencies

  • update core dependencies to v1.92.5 (#101) (e767078)
  • update dependency io.grpc:grpc-bom to v1.27.1 (#106) (46a7c48)
  • update opencensus.version to v0.25.0 (#105) (fcdbab3)
  • update protobuf.version to v3.11.4 (#109) (4f498b4)

Documentation

  • regen: update sample code to set total timeout, add API client header test (#100) (d14a4a1)

1.32.3 (2020-02-03)

Dependencies

  • update core dependencies (#89) (7593432)
  • update dependency com.google.auth:google-auth-library-credentials to v0.20.0 (#86) (f32bd9b)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.5 (#90) (f701446)
  • update protobuf.version to v3.11.3 (#94) (6155816)

1.32.2 (2020-01-14)

Dependencies

  • update core dependencies (#63) (4c1fb09)
  • update dependency com.fasterxml.jackson.core:jackson-core to v2.10.2 (#69) (5e296b8)
  • update dependency com.fasterxml.jackson.core:jackson-databind to v2.10.2 (#70) (2f3a14b)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.4 (#82) (6050055)
  • update dependency com.google.guava:guava-bom to v28.2-android (#76) (c1dcb9f), closes #33
  • update dependency com.google.truth:truth to v1.0.1 (#81) (5d16063)
  • update dependency org.threeten:threetenbp to v1.4.1 (#78) (0db7256)

1.32.1 (2020-01-02)

Bug Fixes

  • add google-cloud-firestore to bom (#65) (b273a58)
  • set google-cloud-conformance-tests to test scope (#44) (03983c3)

Dependencies

  • update dependencies (#51) (ce4c37b), closes #49 #50
  • update dependency com.google.auth:google-auth-library-credentials to v0.19.0 (#48) (d68b457)
  • update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.3 (#55) (6e6644f)
  • update dependency junit:junit to v4.13 (#62) (7f80e44)

Documentation

  • bump bom version in README to 3.1.0 (#47) (d8bebb3)

1.32.0 (2019-12-04)

Features

  • firestore: allow passing POJOs as field values throughout API reference (#6843) (180f5a9)

Dependencies

  • update gax.version to v1.51.0 (#31) (d5125c5)
  • update protobuf packages to v3.11.0 (#26) (862ebce)
  • update protobuf packages to v3.11.1 (#28) (c0c3b2c)