IVersionedCache
Defined in: packages/ddd-core/application/ports/cache.port.ts:92
Extended cache port providing atomic revision-fenced state operations.
Guarantees per-key ordering: a fill started before an observed invalidation cannot repopulate its key afterwards.
Extends
Section titled “Extends”ICache<T>
Type Parameters
Section titled “Type Parameters”T = unknown
Value shape stored by this cache adapter.
Properties
Section titled “Properties”isVersioned
Section titled “isVersioned”
readonlyisVersioned:true
Defined in: packages/ddd-core/application/ports/cache.port.ts:93
Methods
Section titled “Methods”delete()
Section titled “delete()”delete(
key):Promise<void>
Defined in: packages/ddd-core/application/ports/cache.port.ts:45
Removes key when present.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<void>
Inherited from
Section titled “Inherited from”get(
key):Promise<T|undefined>
Defined in: packages/ddd-core/application/ports/cache.port.ts:39
Returns the cached value, or undefined when the key is absent.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<T | undefined>
Inherited from
Section titled “Inherited from”invalidate()
Section titled “invalidate()”invalidate(
key):Promise<string>
Defined in: packages/ddd-core/application/ports/cache.port.ts:105
Atomically advances the key revision and evicts the value.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”Promise<string>
The newly advanced revision.
readState()
Section titled “readState()”readState(
key):Promise<CacheStateEntry<T>>
Defined in: packages/ddd-core/application/ports/cache.port.ts:98
Observes current key state and opaque revision token.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”set(
key,value,options?):Promise<void>
Defined in: packages/ddd-core/application/ports/cache.port.ts:42
Writes a value under key, optionally with TTL/CAS semantics.
Parameters
Section titled “Parameters”string
T
options?
Section titled “options?”Returns
Section titled “Returns”Promise<void>
Inherited from
Section titled “Inherited from”tryFill()
Section titled “tryFill()”tryFill(
key,observedRevision,value,options?):Promise<boolean>
Defined in: packages/ddd-core/application/ports/cache.port.ts:113
Atomically checks that current revision matches observedRevision, writes
value, and advances revision on match.
Parameters
Section titled “Parameters”string
observedRevision
Section titled “observedRevision”string
T
options?
Section titled “options?”Returns
Section titled “Returns”Promise<boolean>
true if write committed; false if rejected due to revision mismatch.