TransactionContext
Class: TransactionContext
Transaction context implementation.
Provides staging for writes/deletes, read tracking for optimistic locking, and commit logic for different transaction modes.
Implements
Constructors
new TransactionContext()
new TransactionContext(
adapter,
resolvedMode,
options): TransactionContextParameters
| Parameter | Type |
|---|---|
adapter | FlashcoreAdapter<string, unknown> |
resolvedMode | ResolvedTransactionMode |
options | Required<TransactionOptions> |
Returns
Accessors
mode
Get Signature
get mode(): ResolvedTransactionModeGet the transaction mode.
Returns
Get the current transaction mode.
Implementation of
mutationCount
Get Signature
get mutationCount(): numberGet the current mutation count.
Returns
number
Get mutation count so far.
Implementation of
ITransactionContext.mutationCount
Methods
commit()
commit(): Promise<void>Commit the transaction. The actual commit logic is determined by the mode.
Returns
Promise<void>
delete()
delete(key): voidStage a delete operation.
Parameters
| Parameter | Type |
|---|---|
key | string |
Returns
void
Implementation of
getOptions()
getOptions(): Required<TransactionOptions>Get transaction options.
Returns
Required<TransactionOptions>
getReadVersions()
getReadVersions(): Map<string, number>Get the read versions map (for commit).
Returns
Map<string, number>
getStagedDeletes()
getStagedDeletes(): Set<string>Get staged deletes.
Returns
Set<string>
getStagedWrites()
getStagedWrites(): Map<string, unknown>Get staged writes.
Returns
Map<string, unknown>
hasPendingOperations()
hasPendingOperations(): booleanCheck if there are any pending operations.
Returns
boolean
read()
read<V>(key): Promise<V>Read a value within the transaction. Tracks the version for conflict detection in optimistic mode.
Type Parameters
| Type Parameter | Default type |
|---|---|
V | unknown |
Parameters
| Parameter | Type |
|---|---|
key | string |
Returns
Promise<V>
Implementation of
rollback()
rollback(): voidRollback the transaction (discard staged operations).
Returns
void
set()
set(key, value): voidStage a set operation.
Parameters
| Parameter | Type |
|---|---|
key | string |
value | unknown |
Returns
void
Implementation of
trackReadVersion()
trackReadVersion(key, version): voidTrack a read version externally (for model operations).
Parameters
| Parameter | Type |
|---|---|
key | string |
version | number |
Returns
void
