@twin.org/core 0.9.2-next.1 → 0.9.2-next.11

package/docs/changelog.md

@@ -1,5 +1,177 @@
 # Changelog
 
+## [0.9.2-next.11](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.10...core-v0.9.2-next.11) (2026-08-20)
+
+
+### Features
+
+* coerce array ([#452](https://github.com/iotaledger/twin-framework/issues/452)) ([2019567](https://github.com/iotaledger/twin-framework/commit/20195673a65fe7179272ac84f37dc927218c128a))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.10 to 0.9.2-next.11
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.10 to 0.9.2-next.11
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.10 to 0.9.2-next.11
+
+## [0.9.2-next.10](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.9...core-v0.9.2-next.10) (2026-08-11)
+
+
+### Features
+
+* add lru and lft cache ([#449](https://github.com/iotaledger/twin-framework/issues/449)) ([67d741e](https://github.com/iotaledger/twin-framework/commit/67d741eab3b89556e3c55053b5a473a4c1592fed))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.9 to 0.9.2-next.10
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.9 to 0.9.2-next.10
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.9 to 0.9.2-next.10
+
+## [0.9.2-next.9](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.8...core-v0.9.2-next.9) (2026-08-10)
+
+
+### Bug Fixes
+
+* number coercion wrongly accepts alpha ([c04c1af](https://github.com/iotaledger/twin-framework/commit/c04c1af24697b6c92a180a71c0722c5673313360))
+* number coercion wrongly accepts alpha ([dd5b193](https://github.com/iotaledger/twin-framework/commit/dd5b193c2501f6d30ca94aa0fc30a6edfe405e6f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.8 to 0.9.2-next.9
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.8 to 0.9.2-next.9
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.8 to 0.9.2-next.9
+
+## [0.9.2-next.8](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.7...core-v0.9.2-next.8) (2026-08-10)
+
+
+### Features
+
+* optimistic locking version property for schemas ([#443](https://github.com/iotaledger/twin-framework/issues/443)) ([1b90987](https://github.com/iotaledger/twin-framework/commit/1b909875dc915a0ec133d8424d013ae7e4ddfb48))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.7 to 0.9.2-next.8
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.7 to 0.9.2-next.8
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.7 to 0.9.2-next.8
+
+## [0.9.2-next.7](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.6...core-v0.9.2-next.7) (2026-08-07)
+
+
+### Features
+
+* linting and dependency update ([1c428ef](https://github.com/iotaledger/twin-framework/commit/1c428efe0391c52632962847d8dad68bd8e5dd00))
+* linting and dependency update ([676b4e9](https://github.com/iotaledger/twin-framework/commit/676b4e9d9bce158065200bbf875bb31da81d166d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.6 to 0.9.2-next.7
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.6 to 0.9.2-next.7
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.6 to 0.9.2-next.7
+
+## [0.9.2-next.6](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.5...core-v0.9.2-next.6) (2026-08-04)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.5 to 0.9.2-next.6
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.5 to 0.9.2-next.6
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.5 to 0.9.2-next.6
+
+## [0.9.2-next.5](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.4...core-v0.9.2-next.5) (2026-08-03)
+
+
+### Features
+
+* move health support to api repo ([#435](https://github.com/iotaledger/twin-framework/issues/435)) ([867f766](https://github.com/iotaledger/twin-framework/commit/867f766afc86607bec6b5cf9c3ab5bd5c41d0b3c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.4 to 0.9.2-next.5
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.4 to 0.9.2-next.5
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.4 to 0.9.2-next.5
+
+## [0.9.2-next.4](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.3...core-v0.9.2-next.4) (2026-07-31)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.3 to 0.9.2-next.4
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.3 to 0.9.2-next.4
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.3 to 0.9.2-next.4
+
+## [0.9.2-next.3](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.2...core-v0.9.2-next.3) (2026-07-30)
+
+
+### Bug Fixes
+
+* coerce and includes ([#429](https://github.com/iotaledger/twin-framework/issues/429)) ([98c9132](https://github.com/iotaledger/twin-framework/commit/98c9132316c0393ede9d6e634bbae9e5ece2d6b9))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.2 to 0.9.2-next.3
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.2 to 0.9.2-next.3
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.2 to 0.9.2-next.3
+
+## [0.9.2-next.2](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.1...core-v0.9.2-next.2) (2026-07-29)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.2-next.1 to 0.9.2-next.2
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.2-next.1 to 0.9.2-next.2
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.2-next.1 to 0.9.2-next.2
+
 ## [0.9.2-next.1](https://github.com/iotaledger/twin-framework/compare/core-v0.9.2-next.0...core-v0.9.2-next.1) (2026-07-28)
 
 

package/docs/reference/classes/Coerce.md

@@ -214,6 +214,34 @@ The duration object, or undefined if the value cannot be coerced.
 
 ***
 
+### array() {#array}
+
+> `static` **array**\<`T`\>(`value`): `T`[] \| `undefined`
+
+Coerce the value to an array.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### value
+
+`unknown`
+
+The value to coerce.
+
+#### Returns
+
+`T`[] \| `undefined`
+
+The coerced array, or undefined if the value cannot be coerced.
+
+***
+
 ### object() {#object}
 
 > `static` **object**\<`T`\>(`value`): `T` \| `undefined`

package/docs/reference/classes/LfuCache.md

@@ -0,0 +1,265 @@
+# Class: LfuCache\<T\>
+
+A fixed-capacity LFU cache with time-to-idle eviction.
+
+Entries are removed in two ways:
+- Capacity eviction: when the cache is full the least-frequently-used entry is removed first.
+Ties in frequency are broken by recency the least-recently-used entry among those with the
+minimum frequency is evicted.
+- TTI eviction: a background timer sweeps idle entries every ttiMs milliseconds.
+The timer only runs while there are entries; it stops automatically when the cache empties.
+
+`get` and `set` increment an entry's access frequency and reset its idle timer.
+`has` and `keys` are pure peeks they evict idle entries but do not affect frequency or TTI.
+Call `destroy` when the cache is no longer needed to stop the background timer.
+
+## Type Parameters
+
+### T
+
+`T`
+
+## Constructors
+
+### Constructor
+
+> **new LfuCache**\<`T`\>(`options?`): `LfuCache`\<`T`\>
+
+Create a new instance of LfuCache.
+
+#### Parameters
+
+##### options?
+
+The cache options.
+
+###### capacity?
+
+`number`
+
+Maximum number of entries. Defaults to 1000. Must be a positive integer.
+
+###### ttiMs?
+
+`number`
+
+Time-to-idle in milliseconds. Defaults to 10000. Must be a positive integer.
+
+###### mutexTimeoutMs?
+
+`number`
+
+Maximum time in milliseconds to wait for getOrSet mutex acquisition.
+
+#### Returns
+
+`LfuCache`\<`T`\>
+
+#### Throws
+
+ValidationError if capacity or ttiMs is not a positive integer.
+
+## Properties
+
+### CLASS\_NAME {#class_name}
+
+> `readonly` `static` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+***
+
+### DEFAULT\_CAPACITY {#default_capacity}
+
+> `readonly` `static` **DEFAULT\_CAPACITY**: `1000` = `1000`
+
+Default capacity.
+
+***
+
+### DEFAULT\_TTI\_MS {#default_tti_ms}
+
+> `readonly` `static` **DEFAULT\_TTI\_MS**: `10000` = `10000`
+
+Default time-to-idle in milliseconds.
+
+## Methods
+
+### count() {#count}
+
+> **count**(): `number`
+
+The number of entries currently held in the cache.
+
+#### Returns
+
+`number`
+
+The number of entries in the cache.
+
+***
+
+### get() {#get}
+
+> **get**(`key`): `T` \| `undefined`
+
+Get a value from the cache.
+Returns undefined if the key is absent or the entry has idled out.
+A successful hit increments the entry's frequency and resets its idle timer.
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to retrieve.
+
+#### Returns
+
+`T` \| `undefined`
+
+The cached value, or undefined on a miss or idle eviction.
+
+***
+
+### set() {#set}
+
+> **set**(`key`, `value`): `void`
+
+Store a value in the cache.
+If the key already exists its value and frequency are updated.
+When the cache is at capacity, idle entries are swept first; if it is still full the
+least-frequently-used entry is evicted (LRU among ties).
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to store.
+
+##### value
+
+`T`
+
+The value to cache.
+
+#### Returns
+
+`void`
+
+***
+
+### getOrSet() {#getorset}
+
+> **getOrSet**(`key`, `valueFactory`): `Promise`\<`T`\>
+
+Atomically get an existing value or create and store it once using an async factory.
+Concurrent calls for the same key are serialized via a mutex.
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to get or create.
+
+##### valueFactory
+
+() => `Promise`\<`T`\>
+
+Async callback used to build a value when the key is absent.
+
+#### Returns
+
+`Promise`\<`T`\>
+
+The existing or newly created value.
+
+***
+
+### has() {#has}
+
+> **has**(`key`): `boolean`
+
+Check whether a key exists in the cache and has not idled out.
+Idle entries are evicted on peek, but a live entry's frequency and TTI are not updated.
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to test.
+
+#### Returns
+
+`boolean`
+
+True if the key is present and not idle.
+
+***
+
+### keys() {#keys}
+
+> **keys**(): `string`[]
+
+Return all keys for entries that have not idled out.
+Idle entries encountered during iteration are evicted.
+Keys are returned in ascending frequency order; within the same frequency, LRU first.
+
+#### Returns
+
+`string`[]
+
+An array of live keys ordered from least-frequently-used to most-frequently-used.
+
+***
+
+### delete() {#delete}
+
+> **delete**(`key`): `void`
+
+Remove an entry from the cache.
+Cancels the background timer if the cache becomes empty.
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to remove.
+
+#### Returns
+
+`void`
+
+***
+
+### clear() {#clear}
+
+> **clear**(): `void`
+
+Remove all entries from the cache and cancel the background timer.
+
+#### Returns
+
+`void`
+
+***
+
+### destroy() {#destroy}
+
+> **destroy**(): `void`
+
+Stop the background idle-sweep timer and release all entries.
+The cache must not be used after this call.
+
+#### Returns
+
+`void`