@requence/event-sourcing 1.2.0 → 1.4.0

package/dist/createEventStore.d.ts

@@ -1,9 +1,10 @@
 import type { AggregateRootApi, AggregateRootSnapshotMethods, AnyAggregateRoot } from './createAggregateRoot.ts';
 import type { CheckpointMethods } from './createCheckpointApi.ts';
 import { type EventListenerApi } from './createEventListener.ts';
-import { type ProcessManagerApi } from './createProcessManager.ts';
+import { type ProcessManagerApi, type ProcessManagerOptions } from './createProcessManager.ts';
 import { type ProjectionApi, type ProjectionApiWithSnapshots, type ProjectionSnapshotMethods } from './createProjection.ts';
 import { type LockCreator } from './lock.ts';
+import { type TransactionOptions } from './transaction.ts';
 import type { BaseInputEvent, BaseOutputEvent, EventTemplate, MaybePromise, Stream, StreamEvents, StreamId, StreamIdEvents } from './utilityTypes.ts';
 import { type WrappedEvent } from './wrappedEventBuilder.ts';
 export type LoadEvents = (select: Stream | StreamId | Stream[] | StreamId[] | StreamEvents | StreamEvents[] | StreamIdEvents | StreamIdEvents[] | null, range?: {
@@ -41,7 +42,7 @@ export interface EventStoreParamsWithoutAggregateRootSnapshots<Root extends AnyA
 }
 export type EventStore<Event extends EventTemplate, Root extends AnyAggregateRoot, SupportsProjectionSnapshots = boolean> = {
     createProjection(name: string): SupportsProjectionSnapshots extends true ? ProjectionApiWithSnapshots<Event> : ProjectionApi<Event>;
-    createProcessManager(name: string): ProcessManagerApi<never, Event>;
+    createProcessManager(name: string, options?: ProcessManagerOptions): ProcessManagerApi<never, Event>;
     createEventListener(name: string): EventListenerApi<Event>;
     rebuild: () => Promise<void>;
     isReady: () => Promise<void>;
@@ -49,7 +50,7 @@ export type EventStore<Event extends EventTemplate, Root extends AnyAggregateRoo
     getAggregateRoot<S extends Root['type']>(type: S): Root extends {
         type: S;
     } ? Root : never;
-    transaction<T extends () => any>(handler: T): Promise<Awaited<ReturnType<T>>>;
+    transaction<T extends () => any>(handler: T, options?: TransactionOptions): Promise<Awaited<ReturnType<T>>>;
 };
 export declare function createEventStore<const Root extends AnyAggregateRoot>(params: EventStoreParamsWithoutAggregateRootSnapshots<Root>): EventStore<EventsFromRoot<Root>, Root, false>;
 export declare function createEventStore<const Root extends AnyAggregateRoot>(params: EventStoreParamsWithAggregateRootSnapshots<Root>): EventStore<EventsFromRoot<Root>, Root, true>;

package/dist/createEventStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createEventStore.d.ts","sourceRoot":"","sources":["../src/createEventStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createEventStore.d.ts","sourceRoot":"","sources":["../src/createEventStore.ts"],"names":[],"mappings":"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"}

package/dist/createEventStore.js

@@ -1,11 +1,11 @@
 import {
   createEventStore
-} from "./chunk-z2yp4rve.js";
+} from "./chunk-57b88rt5.js";
 import"./chunk-24xjphpk.js";
 import"./chunk-ty9bhdvx.js";
-import"./chunk-fkzd741s.js";
+import"./chunk-vvv14qxy.js";
 import"./chunk-6q8mr1sg.js";
-import"./chunk-gq80tgvf.js";
+import"./chunk-pc1q4se9.js";
 import"./chunk-z388cd25.js";
 import"./chunk-3ejt4h7x.js";
 import"./chunk-8qn1nqnh.js";

package/dist/createProcessManager.d.ts

@@ -1,9 +1,21 @@
+import type { SettledOptions } from './createAggregateRoot.ts';
 import { type CheckpointMethods } from './createCheckpointApi.ts';
 import type { LoadEvents, OnProgress } from './createEventStore.ts';
 import type { AfterEffectHandlers, BaseOutputEvent, EventHandlers, EventTemplate, Keys, Merge, StreamEvents } from './utilityTypes.js';
+/**
+ * Options for `createProcessManager`.
+ *
+ * `settled` — default {@link SettledOptions} applied when the process manager
+ * auto-settles the streams its handlers dispatched commands on (explicit
+ * `settled()` calls are not allowed inside a process manager).
+ */
+export type ProcessManagerOptions = {
+    settled?: SettledOptions;
+};
 type ProcessManagerInfo = {
     name: string;
     event: BaseOutputEvent;
+    settledDefaults?: SettledOptions;
 };
 export declare function getProcessManagerInfo(): ProcessManagerInfo | undefined;
 export declare function isInsideProcessManager(): boolean;
@@ -67,6 +79,6 @@ export declare function buildProcessManagerCreator(params: {
     loadEvents: LoadEvents;
     checkpoint: CheckpointMethods;
     onRefresh?: OnProgress;
-}): (name: string) => ProcessManagerApi;
+}): (name: string, options?: ProcessManagerOptions) => ProcessManagerApi;
 export {};
 //# sourceMappingURL=createProcessManager.d.ts.map

package/dist/createProcessManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createProcessManager.d.ts","sourceRoot":"","sources":["../src/createProcessManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createProcessManager.d.ts","sourceRoot":"","sources":["../src/createProcessManager.ts"],"names":[],"mappings":"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"}

package/dist/createProcessManager.js

@@ -2,7 +2,7 @@ import {
   buildProcessManagerCreator,
   getProcessManagerInfo,
   isInsideProcessManager
-} from "./chunk-fkzd741s.js";
+} from "./chunk-vvv14qxy.js";
 import"./chunk-6q8mr1sg.js";
 import"./chunk-yn2sjcg3.js";
 import"./chunk-6yrb30rx.js";

package/dist/drizzle/index.js

@@ -11,18 +11,18 @@ import {
 } from "../chunk-jd4q8fcf.js";
 import {
   createEventStore
-} from "../chunk-z2yp4rve.js";
+} from "../chunk-57b88rt5.js";
 import"../chunk-24xjphpk.js";
 import {
   createAggregateRoot
-} from "../chunk-t7t9mfgn.js";
+} from "../chunk-vep2byx4.js";
 import"../chunk-ty9bhdvx.js";
-import"../chunk-fkzd741s.js";
+import"../chunk-vvv14qxy.js";
 import {
   extendTypes,
   superjson
 } from "../chunk-6q8mr1sg.js";
-import"../chunk-gq80tgvf.js";
+import"../chunk-pc1q4se9.js";
 import"../chunk-z388cd25.js";
 import"../chunk-3ejt4h7x.js";
 import"../chunk-8qn1nqnh.js";

package/dist/index.d.ts

@@ -3,10 +3,11 @@ export { createEventStore } from './createEventStore.ts';
 export type { BaseOutputEvent as Event } from './utilityTypes.d.ts';
 export { type Snapshot as ProjectionSnapshot, isInsideProjection, getProjectionInfo, } from './createProjection.ts';
 export type { Checkpoint } from './createCheckpointApi.ts';
-export { isInsideProcessManager, getProcessManagerInfo, } from './createProcessManager.ts';
+export { type ProcessManagerOptions, isInsideProcessManager, getProcessManagerInfo, } from './createProcessManager.ts';
 export { isInsideEventListener, getEventListenerInfo, } from './createEventListener.ts';
 export * from './errors.ts';
-export { type Snapshot as AggregateRootSnapshot, type AnyAggregateRoot, type AnyStream, createAggregateRoot, } from './createAggregateRoot.ts';
+export { type Snapshot as AggregateRootSnapshot, type AnyAggregateRoot, type AnyStream, type SettledOptions, createAggregateRoot, } from './createAggregateRoot.ts';
+export type { TransactionOptions } from './transaction.ts';
 export { skipRefreshing } from './refresh.ts';
 export { skipReplay } from './replay.ts';
 export declare function isStreamId(stream: Stream): stream is StreamId | StreamIdEvents;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,cAAc,EACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EACL,KAAK,QAAQ,IAAI,kBAAkB,EACnC,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,0BAA0B,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EACL,KAAK,QAAQ,IAAI,qBAAqB,EACtC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,QAAQ,GAAG,cAAc,CAErC;AACD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,YAAY,GAAG,cAAc,CAEzC;AACD,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,cAAc,EACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EACL,KAAK,QAAQ,IAAI,kBAAkB,EACnC,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EACL,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,0BAA0B,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EACL,KAAK,QAAQ,IAAI,qBAAqB,EACtC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,QAAQ,GAAG,cAAc,CAErC;AACD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,YAAY,GAAG,cAAc,CAEzC;AACD,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -4,21 +4,21 @@ import {
 } from "./chunk-jd4q8fcf.js";
 import {
   createEventStore
-} from "./chunk-z2yp4rve.js";
+} from "./chunk-57b88rt5.js";
 import {
   getEventListenerInfo,
   isInsideEventListener
 } from "./chunk-24xjphpk.js";
 import {
   createAggregateRoot
-} from "./chunk-t7t9mfgn.js";
+} from "./chunk-vep2byx4.js";
 import"./chunk-ty9bhdvx.js";
 import {
   getProcessManagerInfo,
   isInsideProcessManager
-} from "./chunk-fkzd741s.js";
+} from "./chunk-vvv14qxy.js";
 import"./chunk-6q8mr1sg.js";
-import"./chunk-gq80tgvf.js";
+import"./chunk-pc1q4se9.js";
 import"./chunk-z388cd25.js";
 import {
   getProjectionInfo,

package/dist/memory/index.js

@@ -4,15 +4,15 @@ import {
 } from "../chunk-jd4q8fcf.js";
 import {
   createEventStore
-} from "../chunk-z2yp4rve.js";
+} from "../chunk-57b88rt5.js";
 import"../chunk-24xjphpk.js";
 import {
   createAggregateRoot
-} from "../chunk-t7t9mfgn.js";
+} from "../chunk-vep2byx4.js";
 import"../chunk-ty9bhdvx.js";
-import"../chunk-fkzd741s.js";
+import"../chunk-vvv14qxy.js";
 import"../chunk-6q8mr1sg.js";
-import"../chunk-gq80tgvf.js";
+import"../chunk-pc1q4se9.js";
 import"../chunk-z388cd25.js";
 import"../chunk-3ejt4h7x.js";
 import"../chunk-8qn1nqnh.js";

package/dist/transaction.d.ts

@@ -1,13 +1,31 @@
+import type { SettledOptions } from './createAggregateRoot.ts';
 export type TransactionDelay = {
     resolve: () => void;
     reject: (error: Error) => void;
     commit: () => Promise<void>;
 };
+/**
+ * Options for a transaction run.
+ *
+ * `settled` — default {@link SettledOptions} applied when the transaction
+ * auto-settles the streams whose commands were dispatched inside the handler
+ * (explicit `settled()` calls are not allowed there).
+ */
+export type TransactionOptions = {
+    settled?: SettledOptions;
+};
 export default function createTransaction(): {
     readonly active: boolean;
+    readonly settledDefaults: SettledOptions | undefined;
+    /**
+     * Runs the handler outside the transaction scope. Used by the settle
+     * retry: a retried append already passed the transaction gate on its
+     * first attempt and must not re-enter the (committed) transaction.
+     */
+    exit<T>(handler: () => T): T;
     delay(): TransactionDelay;
     after(onAfter: () => Promise<any>): void;
-    run<T extends () => any>(handler: T): Promise<any>;
+    run<T extends () => any>(handler: T, options?: TransactionOptions): Promise<any>;
 };
 export type Transaction = ReturnType<typeof createTransaction>;
 //# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,iBAAiB;;aAY5B,gBAAgB;mBAgCV,MAAM,OAAO,CAAC,GAAG,CAAC;QAIvB,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC;EAoB5C;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAgB9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,iBAAiB;;;IAiBrC;;;;OAIG;SACE,CAAC,WAAW,MAAM,CAAC,GAAG,CAAC;aAInB,gBAAgB;mBAgCV,MAAM,OAAO,CAAC,GAAG,CAAC;QAIvB,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,YAAY,kBAAkB;EAyB1E;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/transaction.js

@@ -1,6 +1,6 @@
 import {
   createTransaction
-} from "./chunk-gq80tgvf.js";
+} from "./chunk-pc1q4se9.js";
 export {
   createTransaction as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@requence/event-sourcing",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Event sourcing primitives — aggregate roots, projections, process managers, and event listeners",
   "type": "module",
   "sideEffects": false,

package/src/createAggregateRoot.ts

@@ -12,6 +12,7 @@ import { getProcessManagerInfo } from './createProcessManager.ts'
 import { getProjectionInfo } from './createProjection.ts'
 import {
   CommandError,
+  ConcurrencyError,
   EventValidationError,
   InfiniteLoopError,
   ValidationError,
@@ -135,12 +136,25 @@ type VersionBuilder = <V extends number, S extends z.ZodType>(
   schema: S,
 ) => { schema: S; version: V }
 
+/**
+ * Options for {@link Stream.settled}.
+ *
+ * `maxRetries` — how many times to reload the stream and re-apply the dispatched
+ * commands when the append loses the optimistic-concurrency race
+ * ({@link ConcurrencyError}). Defaults to `0` (no retry — surface the error, the
+ * historical behaviour). Only the append is retried; command handlers must be
+ * pure functions of loaded state and their arguments for retries to be safe.
+ */
+export type SettledOptions = {
+  maxRetries?: number
+}
+
 type Stream<Commands extends Record<string, Command>, State> = {
   [A in keyof Commands]: (
     ...args: Parameters<Commands[A]>
   ) => Stream<Commands, State>
 } & {
-  settled: () => Promise<Stream<Commands, State>>
+  settled: (options?: SettledOptions) => Promise<Stream<Commands, State>>
   state: () => Promise<State>
   transformError: <T extends Error>(
     error: Constructor<T>,
@@ -150,7 +164,7 @@ type Stream<Commands extends Record<string, Command>, State> = {
 }
 
 export type AnyStream = {
-  settled: () => Promise<AnyStream>
+  settled: (options?: SettledOptions) => Promise<AnyStream>
   state: () => Promise<unknown>
   transformError: <T extends Error>(
     error: Constructor<T>,
@@ -475,7 +489,33 @@ export function createAggregateRoot<Name extends string>(type: Name) {
     return version
   }
 
-  const createStream = (state: any, streamId: string) => {
+  // A command as dispatched by the caller, recorded so it can be re-applied
+  // against a freshly-loaded stream when a settle() retries a ConcurrencyError.
+  type RecordedCommand = { name: string; args: any[] }
+
+  type CreateStreamConfig = {
+    // Whether to load the existing stream before commands run. `false` for
+    // newStream (expects version 0); `true` for loadStream and every retry.
+    load?: boolean
+    filter?: (event: BaseOutputEvent) => MaybePromise<boolean>
+    // Seeded on a retry so replayed commands re-apply automatically, and
+    // transformError handlers registered before settle() carry over.
+    replayCommands?: RecordedCommand[]
+    errorHandlerEntries?: [
+      Constructor<Error>,
+      (error: CommandError<Error>) => Error,
+    ][]
+  }
+
+  const createStream = (
+    state: any,
+    streamId: string,
+    config: CreateStreamConfig = {},
+  ) => {
+    // Captured at the dispatch site so a settle() retry can re-apply the
+    // commands within the same AsyncLocalStorage state (user metadata scopes,
+    // process-manager info, …) that the original attempt observed.
+    const dispatchContext = AsyncLocalStorage.snapshot()
     let version = 0
     const snapshotApi = createSnapshotApi?.(
       state,
@@ -485,7 +525,8 @@ export function createAggregateRoot<Name extends string>(type: Name) {
     const errorHandlers = new Map<
       Constructor<Error>,
       (error: CommandError<Error>) => Error
-    >()
+    >(config.errorHandlerEntries)
+    const dispatchedCommands: RecordedCommand[] = []
     let downstreamSettledPromise = () => Promise.resolve()
     let releaseLock!: () => Promise<void>
     let extendLock!: EventHandlerOptions['extendLock']
@@ -563,6 +604,9 @@ export function createAggregateRoot<Name extends string>(type: Name) {
             return api.commands
           }
 
+          // Record for a potential settle() retry (reload + re-apply).
+          dispatchedCommands.push({ name: commandName, args })
+
           const commandId = crypto.randomUUID()
           transactionDelay ??= transaction.delay()
           commandChainTouched = true
@@ -747,11 +791,11 @@ export function createAggregateRoot<Name extends string>(type: Name) {
 
           return state
         },
-        async settled() {
+        async settled(options?: SettledOptions): Promise<any> {
           const parentProcessManager = getProcessManagerInfo()
           if (parentProcessManager) {
             const error = new Error(
-              `aggregateRoot.settled() cannot be called inside a process manager. Attempted on aggregate stream "${type}" within Process Manager ${parentProcessManager.name}.`,
+              `aggregateRoot.settled() cannot be called inside a process manager. Attempted on aggregate stream "${type}" within Process Manager ${parentProcessManager.name}. To configure how dispatched streams settle, pass options to createProcessManager(name, { settled }).`,
             )
             commandChain = commandChain.then(() => error)
             throw error
@@ -759,13 +803,57 @@ export function createAggregateRoot<Name extends string>(type: Name) {
 
           if (transaction.active) {
             const error = new Error(
-              `aggregateRoot.settled() cannot be called inside a transaction. Attempted on aggregate stream "${type}".`,
+              `aggregateRoot.settled() cannot be called inside a transaction. Attempted on aggregate stream "${type}". To configure how dispatched streams settle, pass options to transaction(handler, { settled }).`,
             )
             commandChain = commandChain.then(() => error)
             throw error
           }
 
-          await awaitAll(() => commandChain)
+          const maxRetries = options?.maxRetries ?? 0
+
+          try {
+            await awaitAll(() => commandChain)
+          } catch (error) {
+            // Optimistic-concurrency recovery: another writer advanced the
+            // stream between load and append. Reload and re-apply the same
+            // commands against the fresh version. A failed append leaves this
+            // attempt's lock held (it never reached releaseLock), so release it
+            // before the retry re-acquires — otherwise the retry blocks until
+            // the lock's TTL lapses.
+            if (maxRetries > 0 && error instanceof ConcurrencyError) {
+              await releaseLock?.()
+
+              // Re-create the stream within the async context captured at the
+              // dispatch site, so the replayed commands and event
+              // post-processing observe the same AsyncLocalStorage state as
+              // the original attempt. Two scopes are explicitly exited: the
+              // transaction (the first attempt already passed its commit gate;
+              // re-entering the committed store would swallow errors and
+              // register dead delays) and the upstream collection (this retry
+              // is settled right here, not through another auto-settle
+              // registration).
+              const retryStream = dispatchContext(() =>
+                transaction.exit(() =>
+                  downstreamRootsPromiseStore.exit(() =>
+                    createStream(clone(initialState), streamId, {
+                      load: true,
+                      filter: config.filter,
+                      replayCommands: dispatchedCommands,
+                      errorHandlerEntries: Array.from(errorHandlers),
+                    }),
+                  ),
+                ),
+              )
+
+              return retryStream.commands.settled({
+                ...options,
+                maxRetries: maxRetries - 1,
+              })
+            }
+
+            throw error
+          }
+
           await downstreamSettledPromise()
           return api.commands
         },
@@ -780,8 +868,28 @@ export function createAggregateRoot<Name extends string>(type: Name) {
       },
     }
 
-    registerRootPromiseToUpstream(() => api.commands.settled())
-    transaction.after(() => api.commands.settled())
+    // Streams dispatched inside a process manager or a transaction cannot
+    // call settled() themselves — the surrounding scope settles them when it
+    // completes. Capture the defaults declared on that scope
+    // (createProcessManager / transaction options) so the auto-settle
+    // inherits them.
+    const autoSettleOptions =
+      getProcessManagerInfo()?.settledDefaults ?? transaction.settledDefaults
+
+    registerRootPromiseToUpstream(() => api.commands.settled(autoSettleOptions))
+    transaction.after(() => api.commands.settled(autoSettleOptions))
+
+    // Fold existing events before commands run (loadStream, and every retry).
+    if (config.load) {
+      api.load(config.filter)
+    }
+
+    // Re-apply the caller's commands on a retry so the fresh, reloaded stream
+    // reproduces the original intent against the current version.
+    for (const { name, args } of config.replayCommands ?? []) {
+      ;(api.commands as any)[name](...args)
+    }
+
     return api
   }
 
@@ -861,8 +969,9 @@ export function createAggregateRoot<Name extends string>(type: Name) {
           `aggregateRoot.newStream() cannot be called inside a projection. Attempted on aggregate stream ${type} within Projection ${parentProjectionName}.`,
         )
       }
-      return createStream(clone(initialState), id ?? crypto.randomUUID())
-        .commands as any
+      return createStream(clone(initialState), id ?? crypto.randomUUID(), {
+        load: false,
+      }).commands as any
     },
 
     loadStream(id, filter) {
@@ -878,9 +987,10 @@ export function createAggregateRoot<Name extends string>(type: Name) {
           `aggregateRoot.loadStream("${id}") cannot be called inside a projection. Attempted on aggregate stream ${type} within Projection ${parentProjectionName}.`,
         )
       }
-      const root = createStream(clone(initialState), id)
-      root.load(filter as any)
-      return root.commands as any
+      return createStream(clone(initialState), id, {
+        load: true,
+        filter: filter as any,
+      }).commands as any
     },
 
     linkEventStore(load, append, emit, trans, lock, snap) {

package/src/createEventStore.ts

@@ -13,6 +13,7 @@ import {
 import {
   type InternalProcessManager,
   type ProcessManagerApi,
+  type ProcessManagerOptions,
   buildProcessManagerCreator,
 } from './createProcessManager.ts'
 import {
@@ -24,7 +25,7 @@ import {
 } from './createProjection.ts'
 import lock, { type LockCreator } from './lock.ts'
 import { withRefreshing } from './refresh.ts'
-import createTransaction from './transaction.ts'
+import createTransaction, { type TransactionOptions } from './transaction.ts'
 import type {
   BaseInputEvent,
   BaseOutputEvent,
@@ -126,7 +127,10 @@ export type EventStore<
   ): SupportsProjectionSnapshots extends true
     ? ProjectionApiWithSnapshots<Event>
     : ProjectionApi<Event>
-  createProcessManager(name: string): ProcessManagerApi<never, Event>
+  createProcessManager(
+    name: string,
+    options?: ProcessManagerOptions,
+  ): ProcessManagerApi<never, Event>
   createEventListener(name: string): EventListenerApi<Event>
   rebuild: () => Promise<void>
   isReady: () => Promise<void>
@@ -134,7 +138,10 @@ export type EventStore<
   getAggregateRoot<S extends Root['type']>(
     type: S,
   ): Root extends { type: S } ? Root : never
-  transaction<T extends () => any>(handler: T): Promise<Awaited<ReturnType<T>>>
+  transaction<T extends () => any>(
+    handler: T,
+    options?: TransactionOptions,
+  ): Promise<Awaited<ReturnType<T>>>
 }
 
 export function createEventStore<const Root extends AnyAggregateRoot>(
@@ -357,11 +364,11 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
       }
       return api
     },
-    createProcessManager(name) {
+    createProcessManager(name, options) {
       if (processManagers.has(name)) {
         throw new Error(`Process Manager ${name} is already registered`)
       }
-      const api = baseCreateProcessManager(name)
+      const api = baseCreateProcessManager(name, options)
 
       const internalApi = api as unknown as InternalProcessManager
       internalApi.setRelatedStreamEvents((handlers) =>
@@ -464,8 +471,8 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
         (aggregateRoot) => aggregateRoot.type === type,
       ) as any
     },
-    async transaction(handler) {
-      return transaction.run(handler)
+    async transaction(handler, options) {
+      return transaction.run(handler, options)
     },
   } as EventStore<any, Root>
 

package/src/createProcessManager.ts

@@ -1,5 +1,6 @@
 import { AsyncLocalStorage } from 'node:async_hooks'
 
+import type { SettledOptions } from './createAggregateRoot.ts'
 import {
   type CheckpointApi,
   type CheckpointMethods,
@@ -23,9 +24,21 @@ import type {
   StreamEvents,
 } from './utilityTypes.js'
 
+/**
+ * Options for `createProcessManager`.
+ *
+ * `settled` — default {@link SettledOptions} applied when the process manager
+ * auto-settles the streams its handlers dispatched commands on (explicit
+ * `settled()` calls are not allowed inside a process manager).
+ */
+export type ProcessManagerOptions = {
+  settled?: SettledOptions
+}
+
 type ProcessManagerInfo = {
   name: string
   event: BaseOutputEvent
+  settledDefaults?: SettledOptions
 }
 const processManagerInfoStore = new AsyncLocalStorage<ProcessManagerInfo>()
 
@@ -129,7 +142,7 @@ export function buildProcessManagerCreator(params: {
   checkpoint: CheckpointMethods
   onRefresh?: OnProgress
 }) {
-  return (name: string): ProcessManagerApi => {
+  return (name: string, options?: ProcessManagerOptions): ProcessManagerApi => {
     let idle = true
     let createEventHandlers: (
       state: any,
@@ -196,6 +209,7 @@ export function buildProcessManagerCreator(params: {
             {
               name,
               event,
+              settledDefaults: options?.settled,
             },
             async () => {
               try {

package/src/index.ts

@@ -14,6 +14,7 @@ export {
 } from './createProjection.ts'
 export type { Checkpoint } from './createCheckpointApi.ts'
 export {
+  type ProcessManagerOptions,
   isInsideProcessManager,
   getProcessManagerInfo,
 } from './createProcessManager.ts'
@@ -26,9 +27,11 @@ export {
   type Snapshot as AggregateRootSnapshot,
   type AnyAggregateRoot,
   type AnyStream,
+  type SettledOptions,
   createAggregateRoot,
 } from './createAggregateRoot.ts'
 
+export type { TransactionOptions } from './transaction.ts'
 export { skipRefreshing } from './refresh.ts'
 export { skipReplay } from './replay.ts'