@requence/event-sourcing 1.3.0 → 1.4.0

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-wzw95hzk.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, 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,KAAK,cAAc,EACnB,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-wzw95hzk.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-wzw95hzk.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.3.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

@@ -512,6 +512,10 @@ export function createAggregateRoot<Name extends string>(type: Name) {
     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,
@@ -791,7 +795,7 @@ export function createAggregateRoot<Name extends string>(type: Name) {
           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
@@ -799,7 +803,7 @@ 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
@@ -819,12 +823,27 @@ export function createAggregateRoot<Name extends string>(type: Name) {
             if (maxRetries > 0 && error instanceof ConcurrencyError) {
               await releaseLock?.()
 
-              const retryStream = createStream(clone(initialState), streamId, {
-                load: true,
-                filter: config.filter,
-                replayCommands: dispatchedCommands,
-                errorHandlerEntries: Array.from(errorHandlers),
-              })
+              // 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,
@@ -849,8 +868,16 @@ 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) {

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'
@@ -30,6 +31,7 @@ export {
   createAggregateRoot,
 } from './createAggregateRoot.ts'
 
+export type { TransactionOptions } from './transaction.ts'
 export { skipRefreshing } from './refresh.ts'
 export { skipReplay } from './replay.ts'
 

package/src/tests/processManager.spec.ts

@@ -1,6 +1,11 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { setTimeout } from 'node:timers/promises'
+
 import { describe, expect, it } from 'bun:test'
 
+import { createAggregateRoot } from '../createAggregateRoot.ts'
 import { createUserAggregate, setupEventStore } from './setup.ts'
+import lock from '../lock.ts'
 import { skipRefreshing } from '../refresh.ts'
 
 describe('ProcessManager', () => {
@@ -182,4 +187,69 @@ describe('ProcessManager', () => {
     await eventStore.rebuild()
     expect(called).toBe(1)
   })
+
+  it('applies settled defaults from options to dispatched streams', async () => {
+    const context = new AsyncLocalStorage<string>()
+
+    const sourceAggregate = createAggregateRoot('sources')
+      .withEvents(({ z }) => ({
+        SourceCreated: z.string(),
+      }))
+      .withCommands((event) => ({
+        create(name: string) {
+          return event('SourceCreated', name)
+        },
+      }))
+
+    const targetAggregate = createAggregateRoot('targets')
+      .withEvents(({ z }) => ({
+        Written: z.string(),
+      }))
+      .withCommands((event) => ({
+        async write(delay: number, name: string) {
+          await setTimeout(delay)
+          return event('Written', `${name}:${context.getStore() ?? 'none'}`)
+        },
+      }))
+
+    const { eventStore, pseudoEventStore } = setupEventStore(
+      [sourceAggregate, targetAggregate],
+      { lock: lock(40) }, // 40ms
+    )
+
+    eventStore
+      .createProcessManager('cascade', { settled: { maxRetries: 3 } })
+      .withEventHandlers({
+        onSourceCreated() {
+          context.run('pm', () => {
+            targetAggregate.loadStream('t').write(100, 'PM')
+          })
+        },
+      })
+
+    // The process manager's write holds the lock on targets:t, but its 100ms
+    // command outlives the 40ms lock TTL, so the direct write slips in and
+    // advances the stream to v1. The process manager's append then loses the
+    // race — without the settled defaults declared above the ConcurrencyError
+    // would surface through the source stream's settled(); with them the
+    // auto-settle reloads and re-applies the command.
+    await Promise.all([
+      sourceAggregate.newStream().create('s').settled(),
+      (async () => {
+        await setTimeout(30)
+        await targetAggregate.loadStream('t').write(5, 'direct').settled()
+      })(),
+    ])
+
+    const persisted = pseudoEventStore.filter(
+      (event) => event.streamType === 'targets',
+    )
+    // 'PM:pm' also proves the retry re-ran the command inside the dispatch
+    // site's async context — the AsyncLocalStorage value survived the retry.
+    expect(persisted.map((event) => event.payload)).toEqual([
+      'direct:none',
+      'PM:pm',
+    ])
+    expect(persisted.map((event) => event.streamVersion)).toEqual([1, 2])
+  })
 })

package/src/tests/transaction.spec.ts

@@ -1,3 +1,4 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
 import { setTimeout } from 'node:timers/promises'
 
 import { describe, expect, it } from 'bun:test'
@@ -6,6 +7,7 @@ import { z } from 'zod/v4'
 import { createAggregateRoot } from '../createAggregateRoot.ts'
 import { createUserAggregate, setupEventStore } from './setup.ts'
 import { CommandError } from '../errors.ts'
+import lock from '../lock.ts'
 
 describe('transaction', () => {
   const createAggregateRoots = () => {
@@ -182,4 +184,55 @@ describe('transaction', () => {
       expect(state.created).toBeTrue()
     })
   })
+
+  it('applies settled defaults from options to dispatched streams', async () => {
+    const context = new AsyncLocalStorage<string>()
+
+    const slowAggregate = createAggregateRoot('slow')
+      .withEvents({
+        Written: z.string(),
+      })
+      .withCommands((event) => ({
+        async write(delay: number, name: string) {
+          await setTimeout(delay)
+          return event('Written', `${name}:${context.getStore() ?? 'none'}`)
+        },
+      }))
+
+    const { eventStore, pseudoEventStore } = setupEventStore(slowAggregate, {
+      lock: lock(40), // 40ms
+    })
+
+    // The transaction's write holds the lock on slow:a, but its 100ms command
+    // outlives the 40ms lock TTL, so the direct write slips in and advances
+    // the stream to v1. The transaction's append then loses the race — without
+    // the settled defaults declared below the ConcurrencyError would surface
+    // from the transaction; with them the auto-settle reloads and re-applies
+    // the command.
+    await Promise.all([
+      eventStore.transaction(
+        async () => {
+          context.run('tx', () => {
+            slowAggregate.loadStream('a').write(100, 'TX')
+          })
+        },
+        { settled: { maxRetries: 3 } },
+      ),
+      (async () => {
+        await setTimeout(30)
+        await slowAggregate.loadStream('a').write(5, 'direct').settled()
+      })(),
+    ])
+
+    const persisted = pseudoEventStore.filter(
+      (event) => event.streamType === 'slow',
+    )
+    // 'TX:tx' also proves the retry re-ran the command inside the dispatch
+    // site's async context — the AsyncLocalStorage value survived the retry.
+    expect(persisted.map((event) => event.payload)).toEqual([
+      'direct:none',
+      'TX:tx',
+    ])
+    expect(persisted.map((event) => event.streamVersion)).toEqual([1, 2])
+  })
 })

package/src/transaction.ts

@@ -1,5 +1,7 @@
 import { AsyncLocalStorage } from 'node:async_hooks'
 
+import type { SettledOptions } from './createAggregateRoot.ts'
+
 async function awaitAll(getPromises: () => Promise<any>[]) {
   let promises = getPromises()
 
@@ -20,11 +22,23 @@ export type TransactionDelay = {
   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() {
   const transactionStore = new AsyncLocalStorage<{
     delayPromises: Promise<void>[]
     commitPromises: Promise<void>[]
     afterHandlers: Array<() => Promise<any>>
+    settledDefaults?: SettledOptions
   }>()
 
   return {
@@ -32,6 +46,19 @@ export default function createTransaction() {
       return Boolean(transactionStore.getStore())
     },
 
+    get settledDefaults() {
+      return transactionStore.getStore()?.settledDefaults
+    },
+
+    /**
+     * 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 {
+      return transactionStore.exit(handler)
+    },
+
     delay(): TransactionDelay {
       const store = transactionStore.getStore()
       if (!store) {
@@ -68,14 +95,19 @@ export default function createTransaction() {
       transactionStore.getStore()?.afterHandlers.push(onAfter)
     },
 
-    async run<T extends () => any>(handler: T) {
+    async run<T extends () => any>(handler: T, options?: TransactionOptions) {
       const { resolve, reject, promise } = Promise.withResolvers<void>()
       const delayPromises = [promise]
       const afterHandlers: Array<() => Promise<any>> = []
       let result
       try {
         result = await transactionStore.run(
-          { delayPromises, afterHandlers, commitPromises: [] },
+          {
+            delayPromises,
+            afterHandlers,
+            commitPromises: [],
+            settledDefaults: options?.settled,
+          },
           handler,
         )
         resolve()