A few attributes made optional + comments + Demo section added to README

Author: peterbanda

README.md

@@ -35,7 +35,7 @@ or to *pom.xml* (if you use maven)
 ## Config ⚙️
 
 - Env. variables: `PINECONE_SCALA_CLIENT_API_KEY`, and `PINECONE_SCALA_CLIENT_ENV`
-- File config (default):  [pinecone-scala-client.conf](./pinecone-client/src/main/resources/pinecone-scala-client.conf)
+- File config (default): [pinecone-scala-client.conf](./pinecone-client/src/main/resources/pinecone-scala-client.conf)
 
 ## Usage 👨‍🎓
 
@@ -365,6 +365,9 @@ Examples:
     println(stats)      
   )
 ```
+## Demo
+
+For ready-to-run demos pls. refer to a separate seed project demonstrating how to use the client: [here](https://github.com/cequence-io/pinecone-scala-demo).
 
 ## FAQ 🤔
 

pinecone-core/src/main/scala/io/cequence/pineconescala/domain/PVector.scala

@@ -3,6 +3,6 @@ package io.cequence.pineconescala.domain
 case class PVector(
   id: String,
   values: Seq[Double],
-  sparseValues: Option[SparseVector],
+  sparseValues: Option[SparseVector] = None,
   metadata: Map[String, String]
 )

pinecone-core/src/main/scala/io/cequence/pineconescala/domain/response/CollectionInfo.scala

@@ -2,7 +2,8 @@ package io.cequence.pineconescala.domain.response
 
 case class CollectionInfo(
   name: String,
-  // The size of the collection in bytes.
-  size: Int,
-  status: String
+  // The size of the collection in bytes. Not available when initializing
+  size: Option[Int],
+  dimension: Int,
+  status: String // TODO: this can be potentially an enum (== IndexStatus?)
 )

pinecone-core/src/main/scala/io/cequence/pineconescala/domain/response/QueryResponse.scala

@@ -12,7 +12,7 @@ case class QueryResponse(
 case class Match(
   id: String,
   score: Double,
-  values: Seq[Double],
+  values: Seq[Double], // not returned when includeValues = false
   sparseValues: Option[SparseVector],
-  metadata: Map[String, String]
+  metadata: Option[Map[String, String]] // not returned when includeMetadata = true
 )

pinecone-core/src/main/scala/io/cequence/pineconescala/service/PineconeServiceConsts.scala

@@ -21,7 +21,7 @@ trait PineconeServiceConsts {
     val Query = QuerySettings(
       topK = 10,
       includeValues = false,
-      includeMetadata = false
+      includeMetadata = true // by default include metadata
     )
 
     val CreateIndex = CreateIndexSettings(