feat: add Commanded.Projections.Ecto

.github/workflows/ci.yml

@@ -67,15 +67,6 @@ jobs:
       - name: Install dependencies
         run: mix do deps.get, deps.compile
 
-      - name: Check formatting
-        run: mix format --check-formatted
-
-      - name: Check compilation
-        run: mix compile --warnings-as-errors
-
-      - name: Analyse code
-        run: mix credo --strict
-
       - name: Setup Event Store
         env:
           MIX_ENV: test
@@ -86,6 +77,15 @@ jobs:
           epmd -daemon
           mix test.all
 
+      - name: Check formatting
+        run: mix format --check-formatted
+
+      - name: Check compilation
+        run: mix compile --warnings-as-errors
+
+      - name: Analyse code
+        run: mix credo --strict
+
       - name: Retrieve Dialyzer PLT cache
         uses: actions/cache@v4
         id: plt-cache

config/test.exs

@@ -38,3 +38,13 @@ config :commanded, TestEventStore,
   hostname: "localhost",
   pool_size: 5,
   pool_overflow: 0
+
+config :commanded,
+  ecto_repos: [Commanded.Projections.Repo]
+
+config :commanded, Commanded.Projections.Repo,
+  database: "commanded_projections_test",
+  username: "postgres",
+  password: "postgres",
+  hostname: "localhost",
+  pool: Ecto.Adapters.SQL.Sandbox

guides/explanations/fork-differences.md

@@ -95,3 +95,17 @@ This fork maintains an independent release cycle to introduce new features and i
 - Bundled `Commanded.EventStore.Adapters.EventStore` directly into Commanded
 - Eliminates need for separate `commanded_eventstore_adapter` package dependency
 
+---
+
+### **Ecto Projections Integration**
+
+**Changes:**
+- Integrated `Commanded.Projections.Ecto` directly into Commanded
+- Added Ecto and Ecto SQL as optional dependencies
+- Eliminates need for separate `:commanded_ecto_projections` package dependency
+- Uses nested config format: `config :commanded, Commanded.Projections.Ecto`
+
+**Migration from commanded_ecto_projections:**
+- Update dependency to `{:commanded, "~> 2.1"}` with `{:ecto, "~> 3.11"}`
+- Update config from `config :commanded_ecto_projections, repo: MyApp.Repo` to `config :commanded, Commanded.Projections.Ecto, repo: MyApp.Repo`
+- No code changes required - API remains the same

guides/explanations/read-model-projections.md

@@ -4,7 +4,7 @@ Your read model can be built using a Commanded event handler and whichever stora
 
 ## Ecto projections
 
-You can use the [Commanded Ecto projections](https://github.com/commanded/commanded-ecto-projections) library to build a read model using one of the databases supported by Ecto (PostgreSQL, MySQL, et al).
+Commanded includes built-in support for building read models using Ecto with one of the databases supported by Ecto (PostgreSQL, MySQL, et al). See the [Ecto Projections Getting Started](ecto-projections-getting-started.html) and [Building Read Models with Ecto](building-read-models-with-ecto.html) guides for details.
 
 ### Example