feat: Enhance vector search providers with appsettings.json configuration support

Author: mashrulhaque

README.md

@@ -480,21 +480,47 @@ For production deployments with persistent storage and scalable semantic search,
 dotnet add package EasyAppDev.Blazor.AutoComplete.AI.PostgreSql
 ```
 
+**Using appsettings.json (Recommended):**
+
+```json
+{
+  "VectorSearch": {
+    "PostgreSQL": {
+      "ConnectionString": "Host=localhost;Database=myapp;Username=user;Password=pass",
+      "CollectionName": "products",
+      "EmbeddingDimensions": 1536
+    }
+  },
+  "OpenAI": {
+    "ApiKey": "sk-..."
+  }
+}
+```
+
 ```csharp
 using EasyAppDev.Blazor.AutoComplete.AI.PostgreSql.Extensions;
 
-// Configure services
+builder.Services.AddAutoCompletePostgres<Product>(
+    builder.Configuration,
+    textSelector: p => $"{p.Name} {p.Description} {p.Category}",
+    idSelector: p => p.Id.ToString());
+
+builder.Services.AddAutoCompleteVectorSearch<Product>(builder.Configuration);
+```
+
+**Using explicit configuration:**
+
+```csharp
 builder.Services.AddAutoCompletePostgres<Product>(
     configureOptions: options =>
     {
         options.ConnectionString = "Host=localhost;Database=myapp;Username=user;Password=pass";
         options.CollectionName = "products";
-        options.EmbeddingDimensions = 1536;  // text-embedding-3-small
+        options.EmbeddingDimensions = 1536;
     },
     textSelector: p => $"{p.Name} {p.Description} {p.Category}",
     idSelector: p => p.Id.ToString());
 
-// Add OpenAI embeddings and vector search data source
 builder.Services.AddAutoCompleteVectorSearch<Product>(
     openAiApiKey: "sk-...",
     configureOptions: options =>
@@ -518,16 +544,48 @@ Component usage is unchanged:
 dotnet add package EasyAppDev.Blazor.AutoComplete.AI.AzureSearch
 ```
 
+**Using appsettings.json (Recommended):**
+
+```json
+{
+  "VectorSearch": {
+    "AzureSearch": {
+      "Endpoint": "https://my-search.search.windows.net",
+      "ApiKey": "your-search-api-key",
+      "IndexName": "products",
+      "EmbeddingDimensions": 1536,
+      "EnableHybridSearch": true
+    }
+  },
+  "AzureOpenAI": {
+    "Endpoint": "https://my-openai.openai.azure.com/",
+    "ApiKey": "your-openai-key",
+    "DeploymentName": "text-embedding-ada-002"
+  }
+}
+```
+
 ```csharp
 using EasyAppDev.Blazor.AutoComplete.AI.AzureSearch.Extensions;
 
+builder.Services.AddAutoCompleteAzureSearch<Product>(
+    builder.Configuration,
+    textSelector: p => $"{p.Name} {p.Description}",
+    idSelector: p => p.Id.ToString());
+
+builder.Services.AddAutoCompleteVectorSearchWithAzure<Product>(builder.Configuration);
+```
+
+**Using explicit configuration:**
+
+```csharp
 builder.Services.AddAutoCompleteAzureSearch<Product>(
     configureOptions: options =>
     {
         options.Endpoint = "https://my-search.search.windows.net";
         options.ApiKey = "your-api-key";
         options.IndexName = "products";
-        options.EnableHybridSearch = true;  // Vector + keyword search
+        options.EnableHybridSearch = true;
     },
     textSelector: p => $"{p.Name} {p.Description}",
     idSelector: p => p.Id.ToString());
@@ -542,6 +600,73 @@ builder.Services.AddAutoCompleteVectorSearchWithAzure<Product>(
     });
 ```
 
+### Other Vector Providers
+
+All vector providers support configuration via appsettings.json:
+
+**Pinecone:**
+```json
+{
+  "VectorSearch": {
+    "Pinecone": {
+      "ApiKey": "your-pinecone-api-key",
+      "IndexName": "products",
+      "Namespace": "default",
+      "EmbeddingDimensions": 1536
+    }
+  }
+}
+```
+
+```csharp
+builder.Services.AddAutoCompletePinecone<Product>(
+    builder.Configuration,
+    textSelector: p => p.Name);
+```
+
+**Qdrant:**
+```json
+{
+  "VectorSearch": {
+    "Qdrant": {
+      "Host": "localhost",
+      "Port": 6334,
+      "Https": false,
+      "ApiKey": "your-api-key-for-cloud",
+      "CollectionName": "products",
+      "EmbeddingDimensions": 1536
+    }
+  }
+}
+```
+
+```csharp
+builder.Services.AddAutoCompleteQdrant<Product>(
+    builder.Configuration,
+    textSelector: p => p.Name);
+```
+
+**Azure CosmosDB:**
+```json
+{
+  "VectorSearch": {
+    "CosmosDb": {
+      "ConnectionString": "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=...",
+      "DatabaseName": "myapp",
+      "ContainerName": "products",
+      "EmbeddingDimensions": 1536,
+      "VectorIndexType": "quantizedFlat"
+    }
+  }
+}
+```
+
+```csharp
+builder.Services.AddAutoCompleteCosmosDb<Product>(
+    builder.Configuration,
+    textSelector: p => p.Name);
+```
+
 ### When to Use Vector Providers
 
 | Scenario | Recommendation |

src/EasyAppDev.Blazor.AutoComplete.AI.AzureSearch/EasyAppDev.Blazor.AutoComplete.AI.AzureSearch.csproj

@@ -27,6 +27,8 @@
     <!-- Semantic Kernel Azure AI Search connector (prerelease) -->
     <PackageReference Include="Microsoft.SemanticKernel.Connectors.AzureAISearch" Version="*-*" />
     <PackageReference Include="Azure.Search.Documents" Version="11.*" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="8.0.0" Condition="'$(TargetFramework)' == 'net8.0'" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="9.0.0" Condition="'$(TargetFramework)' == 'net9.0'" />
   </ItemGroup>
 
 </Project>

src/EasyAppDev.Blazor.AutoComplete.AI.AzureSearch/Extensions/AzureSearchServiceExtensions.cs

@@ -1,6 +1,7 @@
 using Azure;
 using Azure.Search.Documents;
 using Azure.Search.Documents.Indexes;
+using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.AI;
 using Microsoft.SemanticKernel.Connectors.AzureAISearch;
@@ -14,6 +15,66 @@ namespace EasyAppDev.Blazor.AutoComplete.AI.AzureSearch.Extensions;
 /// </summary>
 public static class AzureSearchServiceExtensions
 {
+    /// <summary>
+    /// Adds Azure AI Search as the vector search provider using configuration from appsettings.json.
+    /// </summary>
+    /// <typeparam name="TItem">The item type to search.</typeparam>
+    /// <param name="services">The service collection.</param>
+    /// <param name="configuration">The configuration instance.</param>
+    /// <param name="configSection">The configuration section name. Default: "VectorSearch:AzureSearch".</param>
+    /// <returns>The service collection for chaining.</returns>
+    /// <exception cref="ArgumentNullException">Thrown when services or configuration is null.</exception>
+    /// <exception cref="ArgumentException">Thrown when configuration section is missing or options are invalid.</exception>
+    /// <example>
+    /// appsettings.json:
+    /// {
+    ///   "VectorSearch": {
+    ///     "AzureSearch": {
+    ///       "Endpoint": "https://my-search.search.windows.net",
+    ///       "ApiKey": "your-api-key",
+    ///       "IndexName": "products",
+    ///       "EmbeddingDimensions": 1536,
+    ///       "EnableHybridSearch": true
+    ///     }
+    ///   }
+    /// }
+    /// </example>
+    public static IServiceCollection AddAutoCompleteAzureSearchProvider<TItem>(
+        this IServiceCollection services,
+        IConfiguration configuration,
+        string configSection = "VectorSearch:AzureSearch")
+    {
+        ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(configuration);
+
+        var section = configuration.GetSection(configSection);
+        if (!section.Exists())
+        {
+            throw new ArgumentException(
+                $"Configuration section '{configSection}' not found. " +
+                "Ensure your appsettings.json contains the Azure AI Search configuration.",
+                nameof(configSection));
+        }
+
+        var options = new AzureSearchVectorSearchOptions();
+        section.Bind(options);
+
+        return services.AddAutoCompleteAzureSearchProvider<TItem>(opts =>
+        {
+            opts.Endpoint = options.Endpoint;
+            opts.ApiKey = options.ApiKey;
+            opts.IndexName = options.IndexName;
+            opts.EmbeddingDimensions = options.EmbeddingDimensions;
+            opts.DistanceFunction = options.DistanceFunction;
+            opts.EnableHybridSearch = options.EnableHybridSearch;
+            opts.EnableSemanticRanking = options.EnableSemanticRanking;
+            opts.SemanticConfigurationName = options.SemanticConfigurationName;
+            opts.VectorFieldName = options.VectorFieldName;
+            opts.ContentFieldName = options.ContentFieldName;
+            opts.IndexBatchSize = options.IndexBatchSize;
+        });
+    }
+
     /// <summary>
     /// Adds Azure AI Search as the vector search provider.
     /// </summary>
@@ -103,6 +164,31 @@ public static IServiceCollection AddAutoCompleteAzureSearchIndexer<TItem>(
         return services;
     }
 
+    /// <summary>
+    /// Adds Azure AI Search vector search with both provider and indexer using configuration from appsettings.json.
+    /// </summary>
+    /// <typeparam name="TItem">The item type.</typeparam>
+    /// <param name="services">The service collection.</param>
+    /// <param name="configuration">The configuration instance.</param>
+    /// <param name="textSelector">Function to extract searchable text from items.</param>
+    /// <param name="titleSelector">Optional function to extract title from items.</param>
+    /// <param name="idSelector">Optional function to extract unique ID from items.</param>
+    /// <param name="configSection">The configuration section name. Default: "VectorSearch:AzureSearch".</param>
+    /// <returns>The service collection for chaining.</returns>
+    public static IServiceCollection AddAutoCompleteAzureSearch<TItem>(
+        this IServiceCollection services,
+        IConfiguration configuration,
+        Func<TItem, string> textSelector,
+        Func<TItem, string>? titleSelector = null,
+        Func<TItem, string>? idSelector = null,
+        string configSection = "VectorSearch:AzureSearch")
+    {
+        services.AddAutoCompleteAzureSearchProvider<TItem>(configuration, configSection);
+        services.AddAutoCompleteAzureSearchIndexer(textSelector, titleSelector, idSelector);
+
+        return services;
+    }
+
     /// <summary>
     /// Adds Azure AI Search vector search with both provider and indexer.
     /// </summary>

src/EasyAppDev.Blazor.AutoComplete.AI.CosmosDb/EasyAppDev.Blazor.AutoComplete.AI.CosmosDb.csproj

@@ -27,6 +27,8 @@
     <!-- Semantic Kernel CosmosDB NoSQL connector (prerelease) -->
     <PackageReference Include="Microsoft.SemanticKernel.Connectors.CosmosNoSql" Version="*-*" />
     <PackageReference Include="Microsoft.Azure.Cosmos" Version="3.*" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="8.0.0" Condition="'$(TargetFramework)' == 'net8.0'" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="9.0.0" Condition="'$(TargetFramework)' == 'net9.0'" />
   </ItemGroup>
 
 </Project>