@twin.org/core 0.9.1-next.1 → 0.9.1-next.10

package/dist/types/utils/is.d.ts

@@ -26,7 +26,7 @@ export declare class Is {
      * @param value The value to test.
      * @returns True if the value is not null or undefined.
      */
-    static notEmpty(value: unknown): boolean;
+    static notEmpty<T>(value: T): value is NonNullable<T>;
     /**
      * Is the value a string.
      * @param value The value to test.
@@ -113,25 +113,25 @@ export declare class Is {
      * @param value The value to test.
      * @returns True if the value is an empty date.
      */
-    static dateEmpty(value: unknown): boolean;
+    static dateEmpty(value: unknown): value is Date;
     /**
      * Is the value a date string.
      * @param value The value to test.
      * @returns True if the value is a string in ISO 8601 date format.
      */
-    static dateString(value: unknown): boolean;
+    static dateString(value: unknown): value is string;
     /**
      * Is the value a date string.
      * @param value The value to test.
      * @returns True if the value is a string in ISO 8601 date/time format.
      */
-    static dateTimeString(value: unknown): boolean;
+    static dateTimeString(value: unknown): value is string;
     /**
      * Is the value a time string.
      * @param value The value to test.
      * @returns True if the value is a string in ISO 8601 time format.
      */
-    static timeString(value: unknown): boolean;
+    static timeString(value: unknown): value is string;
     /**
      * Is the value a timestamp in seconds.
      * @param value The value to test.

package/dist/types/utils/sharedStore.d.ts

@@ -9,6 +9,16 @@ export declare class SharedStore {
      * @returns The property if it exists.
      */
     static get<T = unknown>(prop: string): T | undefined;
+    /**
+     * Get a property from the shared store, creating and storing it with the
+     * factory if absent. The factory is invoked synchronously so its return
+     * value - including a Promise - is stored before any async yield, making
+     * this safe against concurrent callers.
+     * @param prop The name of the property to get or create.
+     * @param factory A synchronous factory that produces the initial value.
+     * @returns The existing or newly created value.
+     */
+    static get<T = unknown>(prop: string, factory: () => T): T;
     /**
      * Set the property in the shared store.
      * @param prop The name of the property to set.

package/docs/changelog.md

@@ -1,5 +1,228 @@
 # Changelog
 
+## [0.9.1-next.10](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.9...core-v0.9.1-next.10) (2026-07-20)
+
+
+### Bug Fixes
+
+* time coercion ([8ac43f8](https://github.com/iotaledger/twin-framework/commit/8ac43f85fbd521ff54786d92df3e432d7f738b0c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.9 to 0.9.1-next.10
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.9 to 0.9.1-next.10
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.9 to 0.9.1-next.10
+
+## [0.9.1-next.9](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.8...core-v0.9.1-next.9) (2026-07-20)
+
+
+### Features
+
+* improved coercion ([fcc7d98](https://github.com/iotaledger/twin-framework/commit/fcc7d9826f5405be5e3b5414ea53be42f974f9d5))
+
+
+### Bug Fixes
+
+* iso 8601 checks ([#409](https://github.com/iotaledger/twin-framework/issues/409)) ([4427101](https://github.com/iotaledger/twin-framework/commit/442710109b63ec67ca5ee7cb948df742500d0151))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.8 to 0.9.1-next.9
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.8 to 0.9.1-next.9
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.8 to 0.9.1-next.9
+
+## [0.9.1-next.8](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.7...core-v0.9.1-next.8) (2026-07-20)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.7 to 0.9.1-next.8
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.7 to 0.9.1-next.8
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.7 to 0.9.1-next.8
+
+## [0.9.1-next.7](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.6...core-v0.9.1-next.7) (2026-07-09)
+
+
+### Bug Fixes
+
+* settle AsyncCache waiters correctly when a request resolves undefined or null ([#401](https://github.com/iotaledger/twin-framework/issues/401)) ([6ae3f8a](https://github.com/iotaledger/twin-framework/commit/6ae3f8aca688ca76d93ec3964178a3b1a8895453))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.6 to 0.9.1-next.7
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.6 to 0.9.1-next.7
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.6 to 0.9.1-next.7
+
+## [0.9.1-next.6](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.5...core-v0.9.1-next.6) (2026-07-03)
+
+
+### Features
+
+* add wildcard support to the envhelper ([c064d46](https://github.com/iotaledger/twin-framework/commit/c064d46d36bbee8022a741b985d2b64c8f9572e4))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.5 to 0.9.1-next.6
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.5 to 0.9.1-next.6
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.5 to 0.9.1-next.6
+
+## [0.9.1-next.5](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.4...core-v0.9.1-next.5) (2026-06-29)
+
+
+### Features
+
+* urn and header helper extensions ([#395](https://github.com/iotaledger/twin-framework/issues/395)) ([5976756](https://github.com/iotaledger/twin-framework/commit/5976756886d22e5063671052abc4dfa04ce23a53))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.4 to 0.9.1-next.5
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.4 to 0.9.1-next.5
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.4 to 0.9.1-next.5
+
+## [0.9.1-next.4](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.3...core-v0.9.1-next.4) (2026-06-26)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.3 to 0.9.1-next.4
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.3 to 0.9.1-next.4
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.3 to 0.9.1-next.4
+
+## [0.9.1-next.3](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.2...core-v0.9.1-next.3) (2026-06-26)
+
+
+### Features
+
+* add context id features ([#206](https://github.com/iotaledger/twin-framework/issues/206)) ([ef0d4ee](https://github.com/iotaledger/twin-framework/commit/ef0d4ee11a4f5fc6cc6f52a4958ce905c04ee13b))
+* add duration support ([#362](https://github.com/iotaledger/twin-framework/issues/362)) ([24dbe8b](https://github.com/iotaledger/twin-framework/commit/24dbe8b208eb127a52024cb219d31d27731e9ae3))
+* add factory.createIfExists ([aad5a53](https://github.com/iotaledger/twin-framework/commit/aad5a53cef1b1c2e04344ea46244d41e371dff9b))
+* add Factory.getFactory ([ad6cd2d](https://github.com/iotaledger/twin-framework/commit/ad6cd2d30351c145c70212f8cce1b66d5e8a5235))
+* add guard.dateString ([#335](https://github.com/iotaledger/twin-framework/issues/335)) ([a26a166](https://github.com/iotaledger/twin-framework/commit/a26a166eb1f62ece05b2432730cb7354feacecfc))
+* add health method to components ([a88016d](https://github.com/iotaledger/twin-framework/commit/a88016d90d172413e5bc5238dc1b3e35f82fcc2c))
+* add Is.class method ([4988205](https://github.com/iotaledger/twin-framework/commit/498820543e256a130b4888c958fe1d87ca865d7f))
+* add isDefault option to factory registration ([a8a700b](https://github.com/iotaledger/twin-framework/commit/a8a700bb8ddaf7dd5097869a358b8fc5f7c40ce7))
+* add mutex ([#316](https://github.com/iotaledger/twin-framework/issues/316)) ([1027e5a](https://github.com/iotaledger/twin-framework/commit/1027e5ac77aa9804178b4253abdeefd6f1c3d521))
+* add objectHelper.split ([386830a](https://github.com/iotaledger/twin-framework/commit/386830a77f8e842a5b119be0983708e042c3b14b))
+* add partial second support ([39bf087](https://github.com/iotaledger/twin-framework/commit/39bf087ddc113a9bf73e0d0e99f738f6f60c2f2d))
+* add rsa cipher support ([7af6cc6](https://github.com/iotaledger/twin-framework/commit/7af6cc67512d3363bd4a2f2e87bd7733c2800147))
+* add single occurrence array type ([e890e43](https://github.com/iotaledger/twin-framework/commit/e890e4399e75ae5097f3ad8b1007321cbb1ed4ac))
+* add single occurrence array type ([#245](https://github.com/iotaledger/twin-framework/issues/245)) ([771dc78](https://github.com/iotaledger/twin-framework/commit/771dc78025b5546c9c9681be9494a76ab71171c6))
+* add support for health i18n validation ([7a286dd](https://github.com/iotaledger/twin-framework/commit/7a286ddb0c1bfa498bf3a77126cd589042bad6de))
+* add teardown to IComponent interface ([32c173c](https://github.com/iotaledger/twin-framework/commit/32c173cda115c20d3b4cee14b8a29cdc08e91555))
+* add teardown to IComponent interface ([98ce864](https://github.com/iotaledger/twin-framework/commit/98ce8648e709310c4435de334825b381fb4e32cb))
+* add typeName method to factory ([699fcbd](https://github.com/iotaledger/twin-framework/commit/699fcbd1168228401ddb81fdacb959b8cdc4206a))
+* add uuidv7 support ([#219](https://github.com/iotaledger/twin-framework/issues/219)) ([916c657](https://github.com/iotaledger/twin-framework/commit/916c657d270ce99fafe554233739fdd9ca28635b))
+* adding link header helper ([#225](https://github.com/iotaledger/twin-framework/issues/225)) ([703c072](https://github.com/iotaledger/twin-framework/commit/703c0725aceac6b6ec0c4fa729ef832d12fb3fd7))
+* additional nameof operators ([a5aab60](https://github.com/iotaledger/twin-framework/commit/a5aab60bf66a86f1b7ff8af7c4f044cb03706d50))
+* additional RSA methods and async ([1fceee2](https://github.com/iotaledger/twin-framework/commit/1fceee2d1248a24a7620846025fcf906495c07f4))
+* bump version ([c5354fa](https://github.com/iotaledger/twin-framework/commit/c5354fa906f4493c70f2642a9175a66780a10636))
+* concurrency in SharedStore ([#388](https://github.com/iotaledger/twin-framework/issues/388)) ([0610198](https://github.com/iotaledger/twin-framework/commit/0610198ba482273c3f6ba918e34f5875a3659571))
+* configurable timeout for mutex ([2087e04](https://github.com/iotaledger/twin-framework/commit/2087e04464a110a3f009fbc8b066696ed6784fc2))
+* env helper conversion methods ([e8c607e](https://github.com/iotaledger/twin-framework/commit/e8c607e59f6f79d4b1d562e9313babe348778835))
+* eslint migration to flat config ([74427d7](https://github.com/iotaledger/twin-framework/commit/74427d78d342167f7850e49ab87269326355befe))
+* expand error params to accept properties ([032e9fd](https://github.com/iotaledger/twin-framework/commit/032e9fd1388e457cde32ca1005dfe014a5a9c077))
+* factory create and integrity ([#235](https://github.com/iotaledger/twin-framework/issues/235)) ([9f98b99](https://github.com/iotaledger/twin-framework/commit/9f98b99daf46eb365346fae49cc4ffba63e74cb3))
+* health status grouping ([5007c29](https://github.com/iotaledger/twin-framework/commit/5007c29fe4123fe56f754450b993dbe5dc32a057))
+* improve async cache edge cases ([4e57a6e](https://github.com/iotaledger/twin-framework/commit/4e57a6ec4113533b0ea903eae7d469200fa1348c))
+* improve error formatting ([#313](https://github.com/iotaledger/twin-framework/issues/313)) ([5a19623](https://github.com/iotaledger/twin-framework/commit/5a196231bcbf088bf9ba92a93b7478d3b8c5593f))
+* improve Is.function and ModuleHelper.getModuleMethod signatures ([ecf968b](https://github.com/iotaledger/twin-framework/commit/ecf968b02934b3676be4bf7cd2d1e7f8e7af6ce2))
+* improve Is.function definition to retain types ([f20b6b0](https://github.com/iotaledger/twin-framework/commit/f20b6b0dd16e74b75dc359be72b05989305c6410))
+* improve signatures ([45a7d58](https://github.com/iotaledger/twin-framework/commit/45a7d58baa5b6abc8c0735656f393d402fabb4ad))
+* improve signatures ([cdd24be](https://github.com/iotaledger/twin-framework/commit/cdd24be6fb898d33955b6f2f93c3ddbd73582269))
+* improve signatures ([2041ae2](https://github.com/iotaledger/twin-framework/commit/2041ae214cbd8d472d5e8be8d3403cd06a114040))
+* improve signatures ([d8a0ee1](https://github.com/iotaledger/twin-framework/commit/d8a0ee16542134a3f8b0653065239f42045125b4))
+* improve signatures ([1d084c5](https://github.com/iotaledger/twin-framework/commit/1d084c58c7eb41ae50b0ce80ce57e48a22dd3102))
+* improve signatures ([#287](https://github.com/iotaledger/twin-framework/issues/287)) ([c9f38f0](https://github.com/iotaledger/twin-framework/commit/c9f38f00e1cea8759e1105b41872a650c66c00f4))
+* is and coerce accept duration object ([51dffa1](https://github.com/iotaledger/twin-framework/commit/51dffa18066eb86a14c700d90d3c1bd8b322c0fc))
+* locales validation ([#197](https://github.com/iotaledger/twin-framework/issues/197)) ([55fdadb](https://github.com/iotaledger/twin-framework/commit/55fdadb13595ce0047f787bd1d4135d429a99f12))
+* mutex safe usage in browser ([#339](https://github.com/iotaledger/twin-framework/issues/339)) ([02d409f](https://github.com/iotaledger/twin-framework/commit/02d409f211e91267964208d58a27f29791715086))
+* nodeIdentity optional in IComponent methods ([c78dc17](https://github.com/iotaledger/twin-framework/commit/c78dc17f4357d3e1ae40e415f468d3eae13e81f4))
+* shared object buffer ([#355](https://github.com/iotaledger/twin-framework/issues/355)) ([70d82ea](https://github.com/iotaledger/twin-framework/commit/70d82ea8f43f01aa840ae90ee0b1f23b064a07c6))
+* simplify factory options ([7f85a85](https://github.com/iotaledger/twin-framework/commit/7f85a8553dd3008364e8e1104f2e6f6b6595d77e))
+* simplify StringHelper signature ([0390403](https://github.com/iotaledger/twin-framework/commit/039040344952f91ee3c671249bc0e1c8f3b38e17))
+* typescript 6 update ([1d10f31](https://github.com/iotaledger/twin-framework/commit/1d10f31e6516ec622773f45e88af82fe749b384a))
+* update dependencies ([4da77ab](https://github.com/iotaledger/twin-framework/commit/4da77ab30f499e52825ac5a76f51436ceb59c26e))
+* update dependencies ([f3bd015](https://github.com/iotaledger/twin-framework/commit/f3bd015efd169196b7e0335f5cab876ba6ca1d75))
+* urn random switched to using uuidv7 ([606c9a2](https://github.com/iotaledger/twin-framework/commit/606c9a2ed68a10fc7fc2bc5f93388c1b71033154))
+* urn random switched to using uuidv7 ([6a29f8b](https://github.com/iotaledger/twin-framework/commit/6a29f8bd573d06992b7eaa027b1daf4c2a2e1e85))
+* use cause instead of inner for errors ([1f4acc4](https://github.com/iotaledger/twin-framework/commit/1f4acc4d7a6b71a134d9547da9bf40de1e1e49da))
+
+
+### Bug Fixes
+
+* async thread lock ([97a96a5](https://github.com/iotaledger/twin-framework/commit/97a96a57f60c7b45a0ccbbfa1c43199b6e7512f9))
+* ensure __decorate is defined for decorators ([103a563](https://github.com/iotaledger/twin-framework/commit/103a563ce01ebdef6240d2e590e7b026e8692684))
+* improve exception handling in asyncCache ([c81b29b](https://github.com/iotaledger/twin-framework/commit/c81b29b660b152d2f0757d323430287e6491bf59))
+* improve jsdoc comments ([f7c8e43](https://github.com/iotaledger/twin-framework/commit/f7c8e43fab9803dffa6461950d5b9979e25bcd24))
+* linting ([b77511d](https://github.com/iotaledger/twin-framework/commit/b77511de8781707088b1beb4c92f12d7d6e0fd5f))
+* mutex locking ([d5af3c1](https://github.com/iotaledger/twin-framework/commit/d5af3c1e66070f86408ba1410809689c6d22958b))
+* pick non iterable keys ([399399a](https://github.com/iotaledger/twin-framework/commit/399399abfb8947c4eb235df527532ffe186986b3))
+* prevent TOCTOU race in Mutex.getOrFetchLock for concurrent async callers ([#343](https://github.com/iotaledger/twin-framework/issues/343)) ([5238ad1](https://github.com/iotaledger/twin-framework/commit/5238ad1a68e24c69162204b02030c6686c15e9f4))
+* remove misleading undefined from AsyncCache return type ([05b3291](https://github.com/iotaledger/twin-framework/commit/05b32914e03a63c7daf7b77952a2ebedb7ca7f6b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.2 to 0.9.1-next.3
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.2 to 0.9.1-next.3
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.2 to 0.9.1-next.3
+
+## [0.9.1-next.2](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.1...core-v0.9.1-next.2) (2026-06-26)
+
+
+### Features
+
+* concurrency in SharedStore ([#388](https://github.com/iotaledger/twin-framework/issues/388)) ([0610198](https://github.com/iotaledger/twin-framework/commit/0610198ba482273c3f6ba918e34f5875a3659571))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.9.1-next.1 to 0.9.1-next.2
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.9.1-next.1 to 0.9.1-next.2
+    * @twin.org/nameof-vitest-plugin bumped from 0.9.1-next.1 to 0.9.1-next.2
+
 ## [0.9.1-next.1](https://github.com/iotaledger/twin-framework/compare/core-v0.9.1-next.0...core-v0.9.1-next.1) (2026-06-25)
 
 

package/docs/reference/classes/AsyncCache.md

@@ -18,7 +18,9 @@ Cache the results from asynchronous requests.
 
 > `static` **exec**\<`T`\>(`key`, `ttlMs`, `requestMethod`, `cacheFailures?`): `Promise`\<`T`\>
 
-Execute an async request and cache the result.
+Execute an async request and cache the result. A result that resolves to
+undefined or null is treated as a cache miss for later callers, who re-run
+requestMethod themselves instead of waiting on the empty value.
 
 #### Type Parameters
 

package/docs/reference/classes/EnvHelper.md

@@ -51,6 +51,7 @@ The object with camel cased names.
 > `static` **envVarKeyToJsonKey**(`envVarKey`, `prefix?`): `string`
 
 Convert an environment variable key to a JSON key.
+A trailing _* or * is preserved as a wildcard suffix (e.g. TWIN_REST_PATH_* → "restPath*").
 
 #### Parameters
 

package/docs/reference/classes/Is.md

@@ -82,21 +82,27 @@ True if the value is null or undefined.
 
 ### notEmpty() {#notempty}
 
-> `static` **notEmpty**(`value`): `boolean`
+> `static` **notEmpty**\<`T`\>(`value`): `value is NonNullable<T>`
 
 Is the property not null or undefined.
 
+#### Type Parameters
+
+##### T
+
+`T`
+
 #### Parameters
 
 ##### value
 
-`unknown`
+`T`
 
 The value to test.
 
 #### Returns
 
-`boolean`
+`value is NonNullable<T>`
 
 True if the value is not null or undefined.
 
@@ -408,7 +414,7 @@ True if the value is a date.
 
 ### dateEmpty() {#dateempty}
 
-> `static` **dateEmpty**(`value`): `boolean`
+> `static` **dateEmpty**(`value`): `value is Date`
 
 Is the value an empty date.
 
@@ -422,7 +428,7 @@ The value to test.
 
 #### Returns
 
-`boolean`
+`value is Date`
 
 True if the value is an empty date.
 
@@ -430,7 +436,7 @@ True if the value is an empty date.
 
 ### dateString() {#datestring}
 
-> `static` **dateString**(`value`): `boolean`
+> `static` **dateString**(`value`): `value is string`
 
 Is the value a date string.
 
@@ -444,7 +450,7 @@ The value to test.
 
 #### Returns
 
-`boolean`
+`value is string`
 
 True if the value is a string in ISO 8601 date format.
 
@@ -452,7 +458,7 @@ True if the value is a string in ISO 8601 date format.
 
 ### dateTimeString() {#datetimestring}
 
-> `static` **dateTimeString**(`value`): `boolean`
+> `static` **dateTimeString**(`value`): `value is string`
 
 Is the value a date string.
 
@@ -466,7 +472,7 @@ The value to test.
 
 #### Returns
 
-`boolean`
+`value is string`
 
 True if the value is a string in ISO 8601 date/time format.
 
@@ -474,7 +480,7 @@ True if the value is a string in ISO 8601 date/time format.
 
 ### timeString() {#timestring}
 
-> `static` **timeString**(`value`): `boolean`
+> `static` **timeString**(`value`): `value is string`
 
 Is the value a time string.
 
@@ -488,7 +494,7 @@ The value to test.
 
 #### Returns
 
-`boolean`
+`value is string`
 
 True if the value is a string in ISO 8601 time format.
 

package/docs/reference/classes/SharedStore.md

@@ -17,30 +17,84 @@ instance loads of a package.
 
 ### get() {#get}
 
+Get a property from the shared store, creating and storing it with the
+factory if absent. The factory is invoked synchronously so its return
+value - including a Promise - is stored before any async yield, making
+this safe against concurrent callers.
+
+#### Param
+
+**prop**
+
+The name of the property to get or create.
+
+#### Param
+
+**factory**
+
+A synchronous factory that produces the initial value.
+
+#### Call Signature
+
 > `static` **get**\<`T`\>(`prop`): `T` \| `undefined`
 
 Get a property from the shared store.
 
-#### Type Parameters
+##### Type Parameters
 
-##### T
+###### T
 
 `T` = `unknown`
 
-#### Parameters
+##### Parameters
 
-##### prop
+###### prop
 
 `string`
 
 The name of the property to get.
 
-#### Returns
+##### Returns
 
 `T` \| `undefined`
 
 The property if it exists.
 
+#### Call Signature
+
+> `static` **get**\<`T`\>(`prop`, `factory`): `T`
+
+Get a property from the shared store, creating and storing it with the
+factory if absent. The factory is invoked synchronously so its return
+value - including a Promise - is stored before any async yield, making
+this safe against concurrent callers.
+
+##### Type Parameters
+
+###### T
+
+`T` = `unknown`
+
+##### Parameters
+
+###### prop
+
+`string`
+
+The name of the property to get or create.
+
+###### factory
+
+() => `T`
+
+A synchronous factory that produces the initial value.
+
+##### Returns
+
+`T`
+
+The existing or newly created value.
+
 ***
 
 ### set() {#set}

package/docs/reference/classes/Urn.md

@@ -156,7 +156,7 @@ The urn with a prefix.
 
 ### guard() {#guard}
 
-> `static` **guard**(`source`, `property`, `value`): `asserts value is string`
+> `static` **guard**(`source`, `property`, `value`, `options?`): `asserts value is string`
 
 Parse a string into the urn parts.
 
@@ -180,6 +180,22 @@ The name of the property.
 
 The urn to parse.
 
+##### options?
+
+Optional constraints to validate the urn namespace identifier and specific parts.
+
+###### namespaceIdentifier?
+
+`string`
+
+The namespace identifier the urn must match.
+
+###### namespaceSpecific?
+
+`string` \| `string`[]
+
+The namespace specific part(s) the urn must match.
+
 #### Returns
 
 `asserts value is string`
@@ -282,7 +298,7 @@ The namespace method.
 
 ### namespaceSpecificParts() {#namespacespecificparts}
 
-> **namespaceSpecificParts**(`startIndex?`): `string`[]
+> **namespaceSpecificParts**(`startIndex?`, `count?`): `string`[]
 
 Get the namespace specific parts.
 
@@ -294,6 +310,12 @@ Get the namespace specific parts.
 
 The index to start from, defaults to 0.
 
+##### count?
+
+`number`
+
+The number of parts to return, defaults to all remaining parts.
+
 #### Returns
 
 `string`[]

package/locales/en.json

@@ -71,6 +71,8 @@
 			"uint8Array": "Property \"{property}\" must be a Uint8Array, it is \"{value}\"",
 			"function": "Property \"{property}\" must be a function, it is \"{value}\"",
 			"urn": "Property \"{property}\" must be a URN formatted string, it is \"{value}\"",
+			"urnNamespaceIdentifier": "Property \"{property}\" must be a URN with namespace identifier \"{options}\", it is \"{value}\"",
+			"urnNamespaceSpecific": "Property \"{property}\" must be a URN with namespace specific \"{options}\", it is \"{value}\"",
 			"url": "Property \"{property}\" must be a URL formatted string, it is \"{value}\"",
 			"email": "Property \"{property}\" must be string in e-mail format, it is \"{value}\"",
 			"uuidV7": "Property \"{property}\" must be a UUIDv7 formatted string, it is \"{value}\"",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.9.1-next.1",
+	"version": "0.9.1-next.10",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/nameof": "0.9.1-next.1",
+		"@twin.org/nameof": "0.9.1-next.10",
 		"intl-messageformat": "11.2.8",
 		"rfc6902": "5.2.0"
 	},