Release v1.0.1

.github/copilot-instructions.md

@@ -20,8 +20,9 @@
 - Use `ToModel()`/`ToDto()` in `Rest/Dto/Extensions.cs` for mapping
 
 ## Enum & Wire Format
-- Use `ToEnumMemberString()`/`FromEnumMemberString<T>()` for conveting enums to and from strings
+- Use `ToEnumMemberString()`/`FromEnumMemberString<T>()` for converting enums to and from strings
 - Always prefer enums for permission actions and resource types
+- Stick to .NET defaults for JSON serialization, using JsonStringEnumMemberName on enum values for specifying the string conversion, and System.Text.Json.Serialization.JsonStringEnumConverter on properties and fields to speciy the actual conversion on the properties.
 
 ## Testing
 - Unit: xUnit, mock HTTP handler for REST

.github/workflows/main.yaml

@@ -97,6 +97,26 @@ jobs:
           dotnet tool restore
           dotnet csharpier check ${{ steps.changed-files.outputs.all_changed_files }}
 
+      - name: Run analyzer unit tests
+        run: |
+          if [[ "${{ needs.setup.outputs.dry-run }}" == "true" ]]; then
+            echo "🏃 DRY-RUN MODE: Skipping actual test execution"
+            echo "Would run: dotnet test --no-restore --filter \"FullyQualifiedName~Weaviate.Client.Analyzers.Tests\" --logger \"trx;LogFileName=test-analyzer-results.trx\" --collect:\"XPlat Code Coverage\" --results-directory ./test-results"
+
+            # Create dummy test results and coverage files
+            mkdir -p ./test-results
+            mkdir -p ./test-results/coverage
+            echo '<?xml version="1.0" encoding="utf-8"?><coverage line-rate="0.85" branch-rate="0.75"><packages><package name="Weaviate.Client" line-rate="0.85" branch-rate="0.75"><classes></classes></package></packages></coverage>' > ./test-results/coverage/coverage.cobertura.xml
+            echo '<?xml version="1.0" encoding="utf-8"?><TestRun><ResultSummary outcome="Completed"><Counters total="42" executed="42" passed="42" failed="0" error="0" timeout="0" aborted="0" inconclusive="0" passedButRunAborted="0" notRunnable="0" notExecuted="0" disconnected="0" warning="0" completed="0" inProgress="0" pending="0" /></ResultSummary></TestRun>' > ./test-results/test-unit-results.trx
+          else
+            dotnet test --no-restore \
+              --filter "FullyQualifiedName~Weaviate.Client.Analyzers.Tests" \
+              --logger "trx;LogFileName=test-analyzer-results.trx" \
+              --collect:"XPlat Code Coverage" \
+              --results-directory ./test-results \
+              --settings coverlet.runsettings
+          fi
+
       - name: Run unit tests with coverage (or dry-run)
         run: |
           if [[ "${{ needs.setup.outputs.dry-run }}" == "true" ]]; then
@@ -147,7 +167,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        version: ["1.31.20", "1.32.17", "1.33.5", "1.34.0"]
+        version: ["1.32.17", "1.33.5", "1.34.0", "1.35.2", "1.36.0"]
     uses: ./.github/workflows/test-on-weaviate-version.yml
     secrets: inherit
     with:

.gitignore

@@ -485,7 +485,5 @@ $RECYCLE.BIN/
 # Vim temporary swap files
 *.swp
 
-.serena
-
-src/Weaviate.Client.Tests/PublicApiApprovalTests.PublicApi_Should_Not_Change_Unexpectedly.approved.txt
-src/Weaviate.Client.Tests/PublicApiApprovalTests.PublicApi_Should_Not_Change_Unexpectedly.received.txt
+.serena/
+memory/

ci/compose.sh

@@ -27,7 +27,30 @@ function exec_dc {
 }
 
 function compose_up {
-  exec_dc up -d --quiet-pull
+  echo "Pulling Weaviate image ${WEAVIATE_VERSION:-latest}..."
+  echo "Images to be pulled:"
+  exec_dc config --images
+  echo ""
+
+  if ! exec_dc pull; then
+    echo "ERROR: Failed to pull Docker images"
+    echo "Image pull failed for version ${WEAVIATE_VERSION}"
+    return 1
+  fi
+
+  echo "Successfully pulled images. Starting containers..."
+  if ! exec_dc up -d; then
+    echo "ERROR: Failed to start containers"
+    echo "Container status:"
+    docker ps -a
+    echo ""
+    echo "Container logs:"
+    exec_dc logs
+    return 1
+  fi
+
+  echo "Containers started successfully"
+  return 0
 }
 
 function compose_down {
@@ -47,6 +70,25 @@ function wait(){
   while true; do
     # first check if weaviate already responds
     if ! curl -s "$1" > /dev/null; then
+      echo "Weaviate port not responding yet. (waited for ${ALREADY_WAITING}s)"
+      if [ $ALREADY_WAITING -gt $MAX_WAIT_SECONDS ]; then
+        echo "======================================"
+        echo "ERROR: Weaviate did not start up in $MAX_WAIT_SECONDS seconds"
+        echo "======================================"
+        echo ""
+        echo "Docker container status:"
+        docker ps -a --filter "name=weaviate"
+        echo ""
+        echo "Docker compose logs (last 50 lines):"
+        exec_dc logs --tail=50
+        echo ""
+        echo "Checking port accessibility:"
+        nc -zv localhost 8080 || echo "Port 8080 not accessible"
+        echo "======================================"
+        exit 1
+      fi
+      sleep 2
+      (( ALREADY_WAITING+=2 )) || true
       continue
     fi
 
@@ -56,9 +98,21 @@ function wait(){
     if [ "$HTTP_STATUS" -eq 200 ]; then
       break
     else
-      echo "Weaviate is not up yet. (waited for ${ALREADY_WAITING}s)"
+      echo "Weaviate responding but not ready yet. HTTP $HTTP_STATUS (waited for ${ALREADY_WAITING}s)"
       if [ $ALREADY_WAITING -gt $MAX_WAIT_SECONDS ]; then
-        echo "Weaviate did not start up in $MAX_WAIT_SECONDS."
+        echo "======================================"
+        echo "ERROR: Weaviate did not become ready in $MAX_WAIT_SECONDS seconds"
+        echo "======================================"
+        echo ""
+        echo "Docker container status:"
+        docker ps -a --filter "name=weaviate"
+        echo ""
+        echo "Docker compose logs (last 50 lines):"
+        exec_dc logs --tail=50
+        echo ""
+        echo "Weaviate ready endpoint response:"
+        curl -v "$1/v1/.well-known/ready" || true
+        echo "======================================"
         exit 1
       else
         sleep 2
@@ -68,4 +122,4 @@ function wait(){
   done
 
   echo "Weaviate is up and running!"
-}
+}

ci/docker-compose-cluster.yml

@@ -1,6 +1,6 @@
 services:
   weaviate-node-1:
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     restart: on-failure:0
     ports:
       - "8087:8080"
@@ -32,7 +32,7 @@ services:
       - '8080'
       - --scheme
       - http
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     ports:
       - 8088:8080
       - "50059:50051"
@@ -66,7 +66,7 @@ services:
       - '8080'
       - --scheme
       - http
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     ports:
       - 8089:8080
       - "50060:50051"

ci/docker-compose-okta-cc.yml

@@ -8,7 +8,7 @@ services:
       - --scheme
       - http
       - --write-timeout=600s
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     ports:
       - 8082:8082
     restart: on-failure:0

ci/docker-compose-okta-users.yml

@@ -8,7 +8,7 @@ services:
       - --scheme
       - http
       - --write-timeout=600s
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     ports:
       - 8083:8083
     restart: on-failure:0

ci/docker-compose-rbac.yml

@@ -8,7 +8,7 @@ services:
       - --scheme
       - http
       - --write-timeout=600s
-    image: semitechnologies/weaviate:${WEAVIATE_VERSION}
+    image: cr.weaviate.io/semitechnologies/weaviate:${WEAVIATE_VERSION}
     ports:
       - 8092:8085
       - 50063:50051

ci/docker-compose.yml

@@ -30,6 +30,7 @@ services:
       AUTOSCHEMA_ENABLED: 'false'
       DISABLE_TELEMETRY: 'true'
       DISABLE_LAZY_LOAD_SHARDS: 'true'
+      OBJECTS_TTL_DELETE_SCHEDULE: "@every 1m"
       GRPC_MAX_MESSAGE_SIZE: 100000000  # 100mb
       #ASYNC_INDEXING: 'true'
       TRANSFORMERS_INFERENCE_API: http://transformers:8080

ci/start_weaviate.sh

@@ -24,7 +24,17 @@ compose_down
 rm -rf weaviate-data || true
 
 echo "Run Docker compose (Weaviate $WEAVIATE_VERSION)"
-compose_up
+if ! compose_up; then
+  echo "======================================"
+  echo "ERROR: Failed to start Weaviate with Docker Compose"
+  echo "Version: $WEAVIATE_VERSION"
+  echo "======================================"
+  exit 1
+fi
+
+echo "Checking Docker container status after compose up:"
+docker ps -a --filter "name=weaviate"
+echo ""
 
 echo "Wait until all containers are up"
 

docs/CONTRIBUTING.md

@@ -0,0 +1,85 @@
+# Contributing to Weaviate C# Client
+
+This document provides guidelines for contributing to the Weaviate C# client.
+
+## Public API Tracking
+
+This project uses [Microsoft.CodeAnalysis.PublicApiAnalyzers](https://github.com/dotnet/roslyn-analyzers/blob/main/src/PublicApiAnalyzers/PublicApiAnalyzers.Help.md) to track changes to the public API surface. This ensures that breaking changes are intentional and reviewed.
+
+### How It Works
+
+The analyzer tracks public API members in two files located in `src/Weaviate.Client/`:
+
+| File | Purpose |
+|------|---------|
+| `PublicAPI.Shipped.txt` | APIs that have been released in a published version |
+| `PublicAPI.Unshipped.txt` | APIs that are new/changed since the last release |
+
+### When Adding New Public APIs
+
+When you add a new public class, method, property, or other member, you'll see an **RS0016** warning at build time:
+
+```
+warning RS0016: Symbol 'YourNewMethod' is not part of the declared public API
+```
+
+**To fix this:**
+
+1. Use the IDE quick-fix (lightbulb icon) to add the symbol to `PublicAPI.Unshipped.txt`
+2. Or run `dotnet format analyzers --diagnostics RS0016` to auto-fix all missing entries
+
+### When Modifying or Removing Public APIs
+
+If you change or remove a public API member, you'll see an **RS0017** warning:
+
+```
+warning RS0017: Symbol 'OldMethod' is part of the declared API, but could not be found
+```
+
+This is intentional - it alerts you to a potential **breaking change**. Before proceeding:
+
+1. Consider if the change is backward-compatible
+2. If removing/changing is intentional, update the corresponding line in `PublicAPI.Unshipped.txt`
+3. Document the breaking change in the changelog
+
+### Release Process
+
+When preparing a release:
+
+1. Review all entries in `PublicAPI.Unshipped.txt`
+2. Move the entries to `PublicAPI.Shipped.txt`
+3. Clear `PublicAPI.Unshipped.txt` (keeping only `#nullable enable`)
+
+### Suppressed Warnings
+
+The following analyzer warnings are currently suppressed in the project:
+
+| Warning | Reason |
+|---------|--------|
+| RS0026 | Multiple overloads with optional parameters (API design advisory) |
+| RS0027 | Optional parameter ordering (API design advisory) |
+| RS0041 | Oblivious reference types (nullability advisory) |
+
+These are design recommendations, not API tracking issues. They may be addressed in future refactoring efforts.
+
+## Building the Project
+
+```bash
+# Build the main library
+dotnet build src/Weaviate.Client/Weaviate.Client.csproj
+
+# Build and run tests
+dotnet test src/Weaviate.Client.Tests/Weaviate.Client.Tests.csproj
+```
+
+## Running Tests
+
+The test project includes both unit tests and integration tests. Integration tests require a running Weaviate instance.
+
+```bash
+# Run all tests
+dotnet test
+
+# Run only unit tests
+dotnet test --filter "Category!=Integration"
+```

docs/PROPERTY_SYSTEM.md

@@ -58,55 +58,55 @@ The `DataType` enum defines all supported Weaviate data types with `[EnumMember]
 ```csharp
 public enum DataType
 {
-    [System.Runtime.Serialization.EnumMember(Value = "unknown")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("unknown")]
     Unknown,
 
     // Text types
-    [System.Runtime.Serialization.EnumMember(Value = "text")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("text")]
     Text,
-    [System.Runtime.Serialization.EnumMember(Value = "text[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("text[]")]
     TextArray,
 
     // Numeric types
-    [System.Runtime.Serialization.EnumMember(Value = "int")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("int")]
     Int,
-    [System.Runtime.Serialization.EnumMember(Value = "int[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("int[]")]
     IntArray,
-    [System.Runtime.Serialization.EnumMember(Value = "number")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("number")]
     Number,
-    [System.Runtime.Serialization.EnumMember(Value = "number[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("number[]")]
     NumberArray,
 
     // Boolean types
-    [System.Runtime.Serialization.EnumMember(Value = "boolean")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("boolean")]
     Bool,
-    [System.Runtime.Serialization.EnumMember(Value = "boolean[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("boolean[]")]
     BoolArray,
 
     // Date types
-    [System.Runtime.Serialization.EnumMember(Value = "date")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("date")]
     Date,
-    [System.Runtime.Serialization.EnumMember(Value = "date[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("date[]")]
     DateArray,
 
     // UUID types
-    [System.Runtime.Serialization.EnumMember(Value = "uuid")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("uuid")]
     Uuid,
-    [System.Runtime.Serialization.EnumMember(Value = "uuid[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("uuid[]")]
     UuidArray,
 
     // Special types
-    [System.Runtime.Serialization.EnumMember(Value = "geoCoordinates")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("geoCoordinates")]
     GeoCoordinate,
-    [System.Runtime.Serialization.EnumMember(Value = "blob")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("blob")]
     Blob,
-    [System.Runtime.Serialization.EnumMember(Value = "phoneNumber")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("phoneNumber")]
     PhoneNumber,
 
     // Object types
-    [System.Runtime.Serialization.EnumMember(Value = "object")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("object")]
     Object,
-    [System.Runtime.Serialization.EnumMember(Value = "object[]")]
+    [System.Text.Json.Serialization.JsonStringEnumMemberName("object[]")]
     ObjectArray
 }
 ```

docs/VECTOR_API_OVERVIEW.md

@@ -173,7 +173,7 @@ Task<GroupByResult> NearText(
 
 // Extension: NearTextInput record
 Task<WeaviateResult> NearText(
-    NearTextInput input,
+    NearTextInput query,
     ...
 )
 ```