Initial actions

Sources/ComposableArchitecture/Store.swift

@@ -166,11 +166,13 @@ public final class Store<State, Action> {
   ///
   /// - Parameters:
   ///   - initialState: The state to start the application in.
+  ///   - initialAction: An action to send the store when it is created.
   ///   - reducer: The reducer that powers the business logic of the application.
   ///   - prepareDependencies: A closure that can be used to override dependencies that will be accessed
   ///     by the reducer.
   public convenience init<R: Reducer<State, Action>>(
     initialState: @autoclosure () -> R.State,
+    initialAction: @autoclosure () -> R.Action? = nil,
     @ReducerBuilder<State, Action> reducer: () -> R,
     withDependencies prepareDependencies: ((inout DependencyValues) -> Void)? = nil
   ) {
@@ -182,6 +184,9 @@ public final class Store<State, Action> {
       initialState: initialState,
       reducer: reducer.dependency(\.self, dependencies)
     )
+    if let initialAction = initialAction() {
+      send(initialAction)
+    }
   }
 
   init() {

Tests/ComposableArchitectureTests/StoreTests.swift

@@ -1213,6 +1213,17 @@ final class StoreTests: BaseTCATestCase {
       }
     }
   }
+
+  @MainActor
+  func testInitialAction() async {
+    let store = Store<Int, Void>(initialState: 0, initialAction: ()) {
+      Reduce<Int, Void> { state, _ in
+        state += 1
+        return .none
+      }
+    }
+    XCTAssertEqual(store.currentState, 1)
+  }
 }
 
 #if canImport(Testing)