Sql Integration, New Integration README-TEMPLATE and Solution Refinement

.github/workflows/pr.yml

@@ -0,0 +1,41 @@
+# ------------------------------------------------------------------------------
+# <auto-generated>
+#
+#     This code was generated.
+#
+#     - To turn off auto-generation set:
+#
+#         [CustomGitHubActions (AutoGenerate = false)]
+#
+#     - To trigger manual generation invoke:
+#
+#         nuke --generate-configuration GitHubActions_pr --host GitHubActions
+#
+# </auto-generated>
+# ------------------------------------------------------------------------------
+
+name: pr
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - '**/*'
+
+concurrency:
+  group: ${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  ubuntu-latest:
+    name: ubuntu-latest
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            9.x
+      - uses: actions/checkout@v4
+      - name: 'Run: Compile, Test, Pack'
+        run: ./build.cmd Compile Test Pack

CONTRIBUTING.md

@@ -36,17 +36,19 @@ git checkout -b feature/integration-name
 ```
 Follow the repository's structure when adding a new integration:  
 ```
-Elsa.Integrations.ServiceName/
-  ├── Services/
-  ├── Activities/
-  ├── AI/
+[group-name]/
+  └── Elsa.Integrations.[integration-name]/
+      ├── Services/
+      ├── Activities/
+      ├── AI/
+      ...
 ```
 
 ### 5️⃣ Commit & Push  
 Ensure your code follows the project’s conventions and add meaningful commit messages:
 ```sh
 git add .
-git commit -m "Add support for [integration name]"
+git commit -m "Add support for [integration-name]"
 git push origin feature/integration-name
 ```
 
@@ -65,7 +67,7 @@ Our team will review your PR, provide feedback if necessary, and merge it once a
 ## 🛠 Contribution Guidelines
 
 - **Code Style**: Follow `.editorconfig` settings and existing project conventions.  
-- **Documentation**: Every new integration must have a `README.md` inside its folder explaining how to use it.  
+- **Documentation**: Every integration must have a `README.md` at the root of its group folder or project. See [README-TEMPLATE](https://github.com/elsa-workflows/elsa-integrations/blob/main/README-TEMPLATE.md). 
 - **Tests**: If possible, add unit/integration tests for your changes.  
 
 ---

Directory.Build.props

@@ -3,8 +3,8 @@
         <Authors>Elsa Workflows Community</Authors>
         <Copyright>2025</Copyright>
 
-        <PackageProjectUrl>https://github.com/elsa-workflows/elsa-core</PackageProjectUrl>
-        <RepositoryUrl>https://github.com/elsa-workflows/elsa-core</RepositoryUrl>
+        <PackageProjectUrl>https://github.com/elsa-workflows/elsa-integrations</PackageProjectUrl>
+        <RepositoryUrl>https://github.com/elsa-workflows/elsa-integrations</RepositoryUrl>
         <RepositoryType>git</RepositoryType>
 
         <LangVersion>latest</LangVersion>
@@ -21,12 +21,24 @@
         <AnalysisModeDocumentation>Default</AnalysisModeDocumentation>
         <AnalysisLevelDocumentation>latest</AnalysisLevelDocumentation>
 
+		<NuGetAudit>enable</NuGetAudit>
+		<NuGetAuditMode>all</NuGetAuditMode>
+
         <!-- https://github.com/dotnet/sourcelink -->
         <IncludeSymbols>true</IncludeSymbols>
         <SymbolPackageFormat>snupkg</SymbolPackageFormat>
         <EnableTrimAnalyzer>true</EnableTrimAnalyzer>
-    </PropertyGroup>
-    <PropertyGroup>
-        <ElsaVersion>3.5.0-preview.2783</ElsaVersion>
+
+		<TreatWarningsAsErrors>false</TreatWarningsAsErrors>
+	</PropertyGroup>
+	<PropertyGroup>
+		<NoWarn>$(NoWarn);CS0162;CS1591</NoWarn>
+		<!-- IL trimming warnings -->
+		<NoWarn>$(NoWarn);IL2026;IL2046;IL2057;IL2067;IL2070;IL2072;IL2075;IL2087;IL2091</NoWarn>
+	</PropertyGroup>
+
+	<PropertyGroup Label="PackageVersions">
+        <ElsaVersion>3.6.0-preview.2935</ElsaVersion>
+		<ElsaStudioVersion>3.6.0-preview.1018</ElsaStudioVersion>
     </PropertyGroup>
 </Project>

Directory.Packages.props

@@ -1,101 +1,95 @@
 <Project>
-    <PropertyGroup>
-        <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
-        <CentralPackageTransitivePinningEnabled>false</CentralPackageTransitivePinningEnabled>
-    </PropertyGroup>
-    <ItemGroup>
-        <PackageVersion Include="Azure.Identity" Version="1.13.2"/>
-        <PackageVersion Include="Azure.Messaging.ServiceBus" Version="7.18.4"/>
-        <PackageVersion Include="Azure.ResourceManager" Version="1.13.0"/>
-        <PackageVersion Include="Azure.ResourceManager.AppContainers" Version="1.3.0"/>
-        <PackageVersion Include="Azure.ResourceManager.Resources" Version="1.9.0"/>
-        <PackageVersion Include="Azure.ResourceManager.ServiceBus" Version="1.1.0"/>
-        <PackageVersion Include="Azure.Storage.Blobs" Version="12.23.0"/>
-        <PackageVersion Include="BenchmarkDotNet" Version="0.14.0"/>
-        <PackageVersion Include="Bogus" Version="35.6.2"/>
-        <PackageVersion Include="ConfigureAwait.Fody" Version="3.3.2"/>
-        <PackageVersion Include="coverlet.collector" Version="6.0.4"/>
-        <PackageVersion Include="Elsa" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Alterations" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Api.Common" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Common" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore.Common" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore.MySql" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore.Sqlite" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore.SqlServer" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.EntityFrameworkCore.PostgreSql" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Features" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.JavaScript" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Workflows.Core" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Workflows.Api" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Http" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Identity" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.MassTransit" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.MassTransit.RabbitMq" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Webhooks" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Workflows.Management" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Workflows.Runtime" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Workflows.Runtime.ProtoActor" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Tenants" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="Elsa.Testing.Shared.Component" Version="3.4.0-preview.2684"/>
-        <PackageVersion Include="FastEndpoints" Version="5.34.0"/>
-        <PackageVersion Include="FastEndpoints.Security" Version="5.34.0"/>
-        <PackageVersion Include="FastEndpoints.Swagger" Version="5.34.0"/>
-        <PackageVersion Include="Fody" Version="6.9.1"/>
-        <PackageVersion Include="GitHubActionsTestLogger" Version="2.4.1"/>
-        <PackageVersion Include="Humanizer.Core" Version="2.14.1"/>
-        <PackageVersion Include="JetBrains.Annotations" Version="2024.3.0"/>
-        <PackageVersion Include="Microsoft.CodeAnalysis.CSharp.Scripting" Version="4.12.0"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite.Design" Version="1.1.6"/>
-        <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.13.0"/>
-        <PackageVersion Include="Microsoft.SemanticKernel" Version="1.40.0"/>
-        <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="8.0.0"/>
-        <PackageVersion Include="NSubstitute" Version="5.3.0"/>
-        <PackageVersion Include="Refit" Version="8.0.0"/>
-        <PackageVersion Include="Refit.HttpClientFactory" Version="8.0.0"/>
-        <PackageVersion Include="SlackNet" Version="0.15.5"/>
-        <PackageVersion Include="Testcontainers" Version="4.2.0"/>
-        <PackageVersion Include="Testcontainers.PostgreSql" Version="4.2.0"/>
-        <PackageVersion Include="Testcontainers.RabbitMq" Version="4.2.0"/>
-        <PackageVersion Include="WebhooksCore" Version="0.0.1"/>
-        <PackageVersion Include="xunit" Version="2.9.3"/>
-        <PackageVersion Include="xunit.abstractions" Version="2.0.3"/>
-        <PackageVersion Include="xunit.categories" Version="2.0.8"/>
-        <PackageVersion Include="xunit.extensibility.core" Version="2.9.3"/>
-        <PackageVersion Include="xunit.runner.visualstudio" Version="3.0.2"/>
-        <PackageVersion Include="System.Linq.Async" Version="6.0.1"/>
-    </ItemGroup>
-    <ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
-        <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="8.0.13"/>
-        <PackageVersion Include="Microsoft.Data.Sqlite" Version="8.0.13"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.13"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.13"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.13"/>
-        <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="8.0.0"/>
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="8.0.1"/>
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="8.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="8.0.1"/>
-        <PackageVersion Include="Microsoft.Extensions.Logging" Version="8.0.1"/>
-        <PackageVersion Include="Microsoft.Extensions.Logging.Console" Version="8.0.1"/>
-        <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="8.0.11"/>
-        <PackageVersion Include="Pomelo.EntityFrameworkCore.MySql" Version="8.0.2"/>
-        <PackageVersion Include="System.Text.Json" Version="8.0.5"/>
-    </ItemGroup>
-    <ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
-        <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Data.Sqlite" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.Logging" Version="9.0.2"/>
-        <PackageVersion Include="Microsoft.Extensions.Logging.Console" Version="9.0.2"/>
-        <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4"/>
-        <PackageVersion Include="Pomelo.EntityFrameworkCore.MySql" Version="9.0.0-preview.3.efcore.9.0.0"/>
-        <PackageVersion Include="System.Text.Json" Version="9.0.2"/>
-    </ItemGroup>
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+    <CentralPackageTransitivePinningEnabled>false</CentralPackageTransitivePinningEnabled>
+  </PropertyGroup>
+  <ItemGroup Label="Elsa">
+    <PackageVersion Include="Elsa" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Agents.Models" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Alterations" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Api.Common" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Common" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore.Common" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore.MySql" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore.Sqlite" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore.SqlServer" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.EntityFrameworkCore.PostgreSql" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Features" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.JavaScript" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Studio.Workflows" Version="$(ElsaStudioVersion)" />
+    <PackageVersion Include="Elsa.Workflows.Core" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Workflows.Api" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Http" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Identity" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.MassTransit" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.MassTransit.RabbitMq" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Webhooks" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Workflows.Management" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Workflows.Runtime" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Workflows.Runtime.ProtoActor" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Tenants" Version="$(ElsaVersion)" />
+    <PackageVersion Include="Elsa.Testing.Shared.Component" Version="$(ElsaVersion)" />
+  </ItemGroup>
+  <ItemGroup>
+    <PackageVersion Include="Azure.Identity" Version="1.13.2" />
+    <PackageVersion Include="Azure.Messaging.ServiceBus" Version="7.19.0" />
+    <PackageVersion Include="Azure.ResourceManager" Version="1.13.0" />
+    <PackageVersion Include="Azure.ResourceManager.AppContainers" Version="1.3.0" />
+    <PackageVersion Include="Azure.ResourceManager.Resources" Version="1.9.0" />
+    <PackageVersion Include="Azure.ResourceManager.ServiceBus" Version="1.1.0" />
+    <PackageVersion Include="Azure.Storage.Blobs" Version="12.24.0" />
+    <PackageVersion Include="BenchmarkDotNet" Version="0.14.0" />
+    <PackageVersion Include="Bogus" Version="35.6.2" />
+    <PackageVersion Include="ConfigureAwait.Fody" Version="3.3.2" />
+    <PackageVersion Include="coverlet.collector" Version="6.0.4" />
+    <PackageVersion Include="FastEndpoints" Version="5.34.0" />
+    <PackageVersion Include="FastEndpoints.Security" Version="5.34.0" />
+    <PackageVersion Include="FastEndpoints.Swagger" Version="5.34.0" />
+    <PackageVersion Include="Fody" Version="6.9.2" />
+    <PackageVersion Include="GitHubActionsTestLogger" Version="2.4.1" />
+    <PackageVersion Include="Humanizer.Core" Version="2.14.1" />
+    <PackageVersion Include="JetBrains.Annotations" Version="2024.3.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp.Scripting" Version="4.12.0" />
+    <PackageVersion Include="Microsoft.Data.SqlClient" Version="6.0.2" />
+    <PackageVersion Include="Microsoft.Data.Sqlite" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite.Design" Version="1.1.6" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.Logging" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Console" Version="9.0.4" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.13.0" />
+    <PackageVersion Include="Microsoft.SemanticKernel" Version="1.49.0" />
+    <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="8.0.0" />
+    <PackageVersion Include="MySql.Data" Version="9.3.0" />
+    <PackageVersion Include="Npgsql" Version="9.0.3" />
+    <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4" />
+    <PackageVersion Include="NSubstitute" Version="5.3.0" />
+    <PackageVersion Include="Pomelo.EntityFrameworkCore.MySql" Version="9.0.0-preview.3.efcore.9.0.0" />
+    <PackageVersion Include="Refit" Version="8.0.0" />
+    <PackageVersion Include="Refit.HttpClientFactory" Version="8.0.0" />
+    <PackageVersion Include="SlackNet" Version="0.16.1" />
+    <PackageVersion Include="Testcontainers" Version="4.2.0" />
+    <PackageVersion Include="Testcontainers.PostgreSql" Version="4.4.0" />
+    <PackageVersion Include="Testcontainers.RabbitMq" Version="4.4.0" />
+    <PackageVersion Include="WebhooksCore" Version="0.0.1" />
+    <PackageVersion Include="xunit" Version="2.9.3" />
+    <PackageVersion Include="xunit.abstractions" Version="2.0.3" />
+    <PackageVersion Include="xunit.categories" Version="2.0.8" />
+    <PackageVersion Include="xunit.extensibility.core" Version="2.9.3" />
+    <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.0" />
+    <PackageVersion Include="System.Linq.Async" Version="6.0.1" />
+    <PackageVersion Include="System.Text.Json" Version="9.0.4" />
+  </ItemGroup>
+  <ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="8.0.15" />
+  </ItemGroup>
+  <ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.4" />
+  </ItemGroup>
 </Project>