v1.0.0 Release

• Existing users will want to checkout the v1.0.0 Migration Guide for a walkthrough of all the new features and changes.
• New users should start with the README

Serverless indexes are currently in public preview, so make sure to review the current limitations and test thoroughly before using in production.

Changes overview

• Renamed PineconeControlPlaneClient to Pinecone and added overloaded methods, so you are not required to
  construct request objects.
• Added data plane wrappers Index and AsyncIndex, which will eliminate the need to create Java classes for request
  objects. The Index class is for blocking gRPC stub while AsyncIndex is an async gRPC class for data plane
  operations.
• Removed PineconeClient and PineconeConnectionConfig, and renamed PineconeClientConfig to PineconeConfig.
  PineconeConfig supports setting custom gRPC-managed channels for data plane operations along with setting a source
  tag.
• Updated dependencies to address vulnerabilities:
  • io.grpc:grpc-protobuf: from 1.57.0 to 1.61.0
  • io.grpc:grpc-stub: from 1.57.0 to 1.61.0
  • io.grpc:grpc-netty: from 1.57.0 to 1.61.0
  • com.squareup.okhttp3:okhttp → from 4.10.0 to 4.12.0
• Added the following model classes to address the limitations of Java not having a native datatype for unsigned 32-bit integer, which is the expected datatype of Pinecone's backend API. Sparse indices will now accept Java long
  (rather than int), with the input range of [0, 2^32 - 1]. Everything outside of this range will throw a PineconeValidationException:
  • QueryResponseWithUnsignedIndices.java
  • ScoredVectorWithUnsignedIndices.java
  • SparseValuesWithUnsignedIndices.java
  • VectorWithUnsignedIndices
• Added read units as a part of queryResponse.

What's Changed

• Revert "Revert "Refactor dataplane "" by @rohanshah18 in #69
• Add data plane wrapper and accept sparse indices as unsigned 32-bit integer by @rohanshah18 in #70
• Refactor to improve user-experience and delete support for endpoint construction for data plane operations using projectId, env, and indexName by @rohanshah18 in #72
• Add Usage to QueryResponseWithUnsignedIndices by @austin-denoble in #74
• Regenerate gRPC classes after removing grpc-gateway / grpc -> OpenAPI spec metadata by @austin-denoble in #78
• Add PineconeDataPlaneClient Interface by @austin-denoble in #76
• Refactor configs and disable collections and configure tests by @rohanshah18 in #77
• Fix Collection and ConfigureIndex tests by @austin-denoble in #79
• Add upsert(List, String namespace), Rename clients, add createIndexConnection() and createAsyncIndexConnection() by @rohanshah18 in #80
• Refactor CollectionTest, ConfigureIndexTest, and IndexManager to improve integration test speed and reliability by @austin-denoble in #81
• Add Create Index Error + Optional-argument integration tests for Pod + Serverless by @austin-denoble in #82
• Add data plane tests for serverless index by @rohanshah18 in #83
• Add user-agent to control plane operations, add sourceTag, re-enable Pinecone client unit tests by @austin-denoble in #84
• Update OkHttpClient dependency version to 4.12.0 to address vulnerability issues and clean up codebase by @rohanshah18 in #86
• Poll for Index ready during cleanup in ConfigureIndexTest by @austin-denoble in #87
• Update gRPC version to 1.60.2 to address vulnerability concerns and fix data plane integration tests by @rohanshah18 in #88
• Handle nulls for some creation and configure methods and provide alternative method for creating collections by @aulorbe in #91
• Add TestIndexResourcesManager and CleanupAllTestResourcesListener by @austin-denoble in #89
• Abstract away Request objs in the ConfigureIndex method by @aulorbe in #93
• Add concurrent HashMap for storing indexNames and connection objects by @rohanshah18 in #92
• Add new CreateServerlessIndex method by @aulorbe in #94
• [Fix] Accept additional properties in API JSON responses by @jhamon in #95
• [Chore] Build output shows which tests are run by @jhamon in #96
• [Chore] Bump GHA gradle action by @jhamon in #97
• Add new createPodsIndex method by @aulorbe in #98
• Deprecate createIndex method by @aulorbe in #105
• Add new queryByVectorId and queryByVector functions to IndexInterface by @austin-denoble in #106
• Add javadoc docstrings to Pinecone class by @austin-denoble in #104
• Add doc-strings for unsigned indices model classes by @rohanshah18 in #108
• Updated javadoc for Pinecone class by @ssmith-pc in #111
• Add javadoc docstrings to IndexInterface, Index, AsyncIndex classes by @austin-denoble in #109
• Add docstrings for configs by @rohanshah18 in #110
• Update README and examples to reflect v1 changes by @aulorbe in #107

New Contributors

• @aulorbe made their first contribution in #91
• @ssmith-pc made their first contribution in #111

Full Changelog: v0.8.1...v1.0.0