feat: Rename DataTimeout to InsertTimeout and update related documentation

Author: mpartipilo

docs/DEPENDENCY_INJECTION.md

@@ -52,7 +52,7 @@ var app = builder.Build();
     "UseSsl": false,
     "DefaultTimeout": "00:00:30",
     "InitTimeout": "00:00:02",
-    "DataTimeout": "00:02:00",
+    "InsertTimeout": "00:02:00",
     "QueryTimeout": "00:01:00"
   }
 }
@@ -108,7 +108,7 @@ public class CatService
 | `Credentials` | `ICredentials?` | `null` | Authentication credentials |
 | `DefaultTimeout` | `TimeSpan?` | `30s` | Default timeout for all operations |
 | `InitTimeout` | `TimeSpan?` | `2s` | Timeout for initialization |
-| `DataTimeout` | `TimeSpan?` | `120s` | Timeout for data operations |
+| `InsertTimeout` | `TimeSpan?` | `120s` | Timeout for data operations |
 | `QueryTimeout` | `TimeSpan?` | `60s` | Timeout for query operations |
 | `Headers` | `Dictionary<string, string>?` | `null` | Additional HTTP headers |
 | `RetryPolicy` | `RetryPolicy?` | Default | Retry policy for failed requests |
@@ -150,11 +150,13 @@ builder.Services.AddWeaviate(options => { ... }, eagerInitialization: true);
 ```
 
 **Benefits:**
+
 - ✅ Client is ready when first request arrives
 - ✅ Fails fast if connection issues exist
 - ✅ Simpler usage - no need to await initialization
 
 **How it works:**
+
 1. `WeaviateClient` is constructed with DI
 2. `IHostedService` runs on app startup
 3. Calls `client.InitializeAsync()` which:
@@ -172,11 +174,13 @@ builder.Services.AddWeaviate(options => { ... }, eagerInitialization: false);
 ```
 
 **When to use:**
+
 - Application startup time is critical
 - Weaviate connection isn't needed immediately
 - You want to handle connection failures gracefully
 
 **Usage with lazy initialization:**
+
 ```csharp
 public class MyService
 {
@@ -222,6 +226,7 @@ var client = await Connect.Local(
 ```
 
 These methods:
+
 - ✅ Return a fully initialized client
 - ✅ Use async initialization (no blocking)
 - ✅ Follow the same REST → Meta → gRPC initialization flow
@@ -345,6 +350,7 @@ public class MyIntegrationTests : IAsyncLifetime
    - Runs initialization task (only once, thread-safe)
 
 3. **Initialization Task**
+
    ```
    ┌─────────────────────────────────────────┐
    │ 1. Initialize Token Service (OAuth, etc)│
@@ -366,16 +372,18 @@ public class MyIntegrationTests : IAsyncLifetime
    - `EnsureInitializedAsync()` returns immediately (already initialized)
    - No performance penalty
 
-### No More `GetAwaiter().GetResult()`!
+### No More `GetAwaiter().GetResult()`
 
 The old pattern had to block:
+
 ```csharp
 // ❌ Old: Blocking async call in constructor
 var client = new WeaviateClient(config);
 var meta = GetMetaAsync().GetAwaiter().GetResult(); // Deadlock risk!
 ```
 
 The new pattern is fully async:
+
 ```csharp
 // ✅ New: Lazy async initialization
 var client = new WeaviateClient(options);
@@ -390,6 +398,7 @@ await client.InitializeAsync(); // Or called automatically
 ### From Old Constructor Pattern
 
 **Before:**
+
 ```csharp
 var config = new ClientConfiguration
 {
@@ -401,6 +410,7 @@ var client = new WeaviateClient(config);
 ```
 
 **After (DI):**
+
 ```csharp
 builder.Services.AddWeaviate(options =>
 {
@@ -413,6 +423,7 @@ public MyService(WeaviateClient client) { ... }
 ```
 
 **After (Non-DI):**
+
 ```csharp
 var client = await Connect.Local();
 // Or
@@ -424,6 +435,7 @@ await client.InitializeAsync();
 ### From `WeaviateClientBuilder`
 
 **Before:**
+
 ```csharp
 var client = await WeaviateClientBuilder
     .Local()
@@ -432,6 +444,7 @@ var client = await WeaviateClientBuilder
 ```
 
 **After (still works!):**
+
 ```csharp
 // This pattern still works exactly as before
 var client = await WeaviateClientBuilder
@@ -441,6 +454,7 @@ var client = await WeaviateClientBuilder
 ```
 
 **Or with DI:**
+
 ```csharp
 builder.Services.AddWeaviate(options =>
 {

src/Weaviate.Client/ClientConfiguration.cs

@@ -14,7 +14,7 @@ public sealed record ClientConfiguration(
     ICredentials? Credentials = null,
     TimeSpan? DefaultTimeout = null,
     TimeSpan? InitTimeout = null,
-    TimeSpan? DataTimeout = null,
+    TimeSpan? InsertTimeout = null,
     TimeSpan? QueryTimeout = null,
     RetryPolicy? RetryPolicy = null,
     DelegatingHandler[]? CustomHandlers = null,

src/Weaviate.Client/DependencyInjection/WeaviateOptions.cs

@@ -63,7 +63,7 @@ public class WeaviateOptions
     /// <summary>
     /// Timeout for data operations (Insert, Delete, Update, Reference management).
     /// </summary>
-    public TimeSpan? DataTimeout { get; set; }
+    public TimeSpan? InsertTimeout { get; set; }
 
     /// <summary>
     /// Timeout for query/search operations (FetchObjects, NearText, BM25, Hybrid, etc.).
@@ -92,7 +92,7 @@ internal ClientConfiguration ToClientConfiguration()
             Credentials: Credentials,
             DefaultTimeout: DefaultTimeout,
             InitTimeout: InitTimeout,
-            DataTimeout: DataTimeout,
+            InsertTimeout: InsertTimeout,
             QueryTimeout: QueryTimeout,
             RetryPolicy: RetryPolicy
         );

src/Weaviate.Client/DependencyInjection/WeaviateServiceCollectionExtensions.cs

@@ -108,7 +108,7 @@ public static IServiceCollection AddWeaviate(
     /// <param name="headers">Additional HTTP headers to include in requests.</param>
     /// <param name="defaultTimeout">Default timeout for all operations.</param>
     /// <param name="initTimeout">Timeout for initialization operations.</param>
-    /// <param name="dataTimeout">Timeout for data operations.</param>
+    /// <param name="insertTimeout">Timeout for data operations.</param>
     /// <param name="queryTimeout">Timeout for query operations.</param>
     /// <param name="eagerInitialization">Whether to initialize the client eagerly on application startup. Default is true.</param>
     /// <returns>The service collection for method chaining.</returns>
@@ -122,7 +122,7 @@ public static IServiceCollection AddWeaviateLocal(
         Dictionary<string, string>? headers = null,
         TimeSpan? defaultTimeout = null,
         TimeSpan? initTimeout = null,
-        TimeSpan? dataTimeout = null,
+        TimeSpan? insertTimeout = null,
         TimeSpan? queryTimeout = null,
         bool eagerInitialization = true
     )
@@ -139,7 +139,7 @@ public static IServiceCollection AddWeaviateLocal(
                 options.Headers = headers;
                 options.DefaultTimeout = defaultTimeout;
                 options.InitTimeout = initTimeout;
-                options.DataTimeout = dataTimeout;
+                options.InsertTimeout = insertTimeout;
                 options.QueryTimeout = queryTimeout;
             },
             eagerInitialization
@@ -158,7 +158,7 @@ public static IServiceCollection AddWeaviateLocal(
     /// <param name="headers">Additional HTTP headers to include in requests.</param>
     /// <param name="defaultTimeout">Default timeout for all operations.</param>
     /// <param name="initTimeout">Timeout for initialization operations.</param>
-    /// <param name="dataTimeout">Timeout for data operations.</param>
+    /// <param name="insertTimeout">Timeout for data operations.</param>
     /// <param name="queryTimeout">Timeout for query operations.</param>
     /// <param name="eagerInitialization">Whether to initialize the client eagerly on application startup. Default is true.</param>
     /// <returns>The service collection for method chaining.</returns>
@@ -169,7 +169,7 @@ public static IServiceCollection AddWeaviateCloud(
         Dictionary<string, string>? headers = null,
         TimeSpan? defaultTimeout = null,
         TimeSpan? initTimeout = null,
-        TimeSpan? dataTimeout = null,
+        TimeSpan? insertTimeout = null,
         TimeSpan? queryTimeout = null,
         bool eagerInitialization = true
     )
@@ -186,7 +186,7 @@ public static IServiceCollection AddWeaviateCloud(
                 options.Headers = headers;
                 options.DefaultTimeout = defaultTimeout;
                 options.InitTimeout = initTimeout;
-                options.DataTimeout = dataTimeout;
+                options.InsertTimeout = insertTimeout;
                 options.QueryTimeout = queryTimeout;
             },
             eagerInitialization
@@ -248,7 +248,7 @@ Action<WeaviateOptions> configureOptions
     /// <param name="headers">Additional HTTP headers to include in requests.</param>
     /// <param name="defaultTimeout">Default timeout for all operations.</param>
     /// <param name="initTimeout">Timeout for initialization operations.</param>
-    /// <param name="dataTimeout">Timeout for data operations.</param>
+    /// <param name="insertTimeout">Timeout for data operations.</param>
     /// <param name="queryTimeout">Timeout for query operations.</param>
     /// <returns>The service collection for method chaining.</returns>
     public static IServiceCollection AddWeaviateLocal(
@@ -262,7 +262,7 @@ public static IServiceCollection AddWeaviateLocal(
         Dictionary<string, string>? headers = null,
         TimeSpan? defaultTimeout = null,
         TimeSpan? initTimeout = null,
-        TimeSpan? dataTimeout = null,
+        TimeSpan? insertTimeout = null,
         TimeSpan? queryTimeout = null
     )
     {
@@ -279,7 +279,7 @@ public static IServiceCollection AddWeaviateLocal(
                 options.Headers = headers;
                 options.DefaultTimeout = defaultTimeout;
                 options.InitTimeout = initTimeout;
-                options.DataTimeout = dataTimeout;
+                options.InsertTimeout = insertTimeout;
                 options.QueryTimeout = queryTimeout;
             }
         );
@@ -311,7 +311,7 @@ Action<WeaviateOptions> configureOptions
     /// <param name="headers">Additional HTTP headers to include in requests.</param>
     /// <param name="defaultTimeout">Default timeout for all operations.</param>
     /// <param name="initTimeout">Timeout for initialization operations.</param>
-    /// <param name="dataTimeout">Timeout for data operations.</param>
+    /// <param name="insertTimeout">Timeout for data operations.</param>
     /// <param name="queryTimeout">Timeout for query operations.</param>
     /// <returns>The service collection for method chaining.</returns>
     public static IServiceCollection AddWeaviateCloud(
@@ -322,7 +322,7 @@ public static IServiceCollection AddWeaviateCloud(
         Dictionary<string, string>? headers = null,
         TimeSpan? defaultTimeout = null,
         TimeSpan? initTimeout = null,
-        TimeSpan? dataTimeout = null,
+        TimeSpan? insertTimeout = null,
         TimeSpan? queryTimeout = null
     )
     {
@@ -339,7 +339,7 @@ public static IServiceCollection AddWeaviateCloud(
                 options.Headers = headers;
                 options.DefaultTimeout = defaultTimeout;
                 options.InitTimeout = initTimeout;
-                options.DataTimeout = dataTimeout;
+                options.InsertTimeout = insertTimeout;
                 options.QueryTimeout = queryTimeout;
             }
         );

src/Weaviate.Client/WeaviateClient.cs

@@ -141,7 +141,7 @@ static bool IsWeaviateDomain(string url)
 
     public TimeSpan? DefaultTimeout => Configuration.DefaultTimeout;
     public TimeSpan? InitTimeout => Configuration.InitTimeout;
-    public TimeSpan? DataTimeout => Configuration.DataTimeout;
+    public TimeSpan? InsertTimeout => Configuration.InsertTimeout;
     public TimeSpan? QueryTimeout => Configuration.QueryTimeout;
 
     /// <summary>

src/Weaviate.Client/WeaviateClientBuilder.cs

@@ -288,69 +288,6 @@ public async Task<WeaviateClient> BuildAsync()
         return await config.BuildAsync();
     }
 
-    /// <summary>
-    /// Synchronous build method - deprecated. Use BuildAsync() instead.
-    /// </summary>
-    [Obsolete(
-        "Use BuildAsync() instead. Synchronous initialization can cause blocking issues.",
-        false
-    )]
-    public WeaviateClient Build()
-    {
-        var loggerFactory = LoggerFactory.Create(builder => builder.AddSimpleConsole());
-        var logger = loggerFactory.CreateLogger<WeaviateClient>();
-
-        var config = new ClientConfiguration(
-            _restEndpoint,
-            _restPath,
-            _grpcEndpoint,
-            _grpcPath,
-            _restPort,
-            _grpcPort,
-            _useSsl,
-            _headers.Count > 0 ? new Dictionary<string, string>(_headers) : null,
-            _credentials,
-            _defaultTimeout,
-            _initTimeout,
-            _insertTimeout,
-            _queryTimeout,
-            _retryPolicy,
-            _customHandlers.Count > 0 ? _customHandlers.ToArray() : null
-        );
-
-        // Initialize token service synchronously
-        var tokenService = ClientConfiguration.InitializeTokenServiceSync(config);
-
-        // Create REST client
-        var restClient = WeaviateClient.CreateRestClient(
-            config,
-            _httpMessageHandler,
-            tokenService,
-            logger
-        );
-
-        // Fetch metadata synchronously (blocking)
-        ulong? maxMessageSize = null;
-        try
-        {
-            var metaDto = restClient.GetMeta(CancellationToken.None).GetAwaiter().GetResult();
-            if (metaDto?.GrpcMaxMessageSize is not null)
-            {
-                maxMessageSize = Convert.ToUInt64(metaDto.GrpcMaxMessageSize);
-            }
-        }
-        catch
-        {
-            // If metadata fetch fails, use defaults
-        }
-
-        // Create gRPC client with metadata
-        var grpcClient = WeaviateClient.CreateGrpcClient(config, tokenService, maxMessageSize);
-
-        // Return the client with pre-built services
-        return new WeaviateClient(config, restClient, grpcClient, logger);
-    }
-
     public static implicit operator Task<WeaviateClient>(WeaviateClientBuilder builder) =>
         builder.BuildAsync();
 }

src/Weaviate.Client/WeaviateDefaults.cs

@@ -19,9 +19,9 @@ public static class WeaviateDefaults
 
     /// <summary>
     /// Default timeout for data operations (Insert, Delete, Update, Reference management). Default is 120 seconds.
-    /// This can be overridden per client via ClientConfiguration.WithDataTimeout().
+    /// This can be overridden per client via ClientConfiguration.WithInsertTimeout().
     /// </summary>
-    public static TimeSpan DataTimeout { get; set; } = TimeSpan.FromSeconds(120);
+    public static TimeSpan InsertTimeout { get; set; } = TimeSpan.FromSeconds(120);
 
     /// <summary>
     /// Default timeout for query/search operations (FetchObjects, NearText, BM25, Hybrid, etc.). Default is 60 seconds.