@twin.org/context 0.0.3-next.3 → 0.0.3-next.31

package/README.md

@@ -1,6 +1,6 @@
 # TWIN Framework Context
 
-This package contains helper methods and classes for using contexts.
+This package is part of the framework workspace and provides helper methods/classes for context handling to support consistent development workflows across the ecosystem.
 
 ## Installation
 

package/dist/es/models/IContextIdHandler.js

@@ -1,4 +1,2 @@
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 export {};
 //# sourceMappingURL=IContextIdHandler.js.map

package/dist/es/models/IContextIdHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"IContextIdHandler.js","sourceRoot":"","sources":["../../../src/models/IContextIdHandler.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Interface describing a context ID handler.\n */\nexport interface IContextIdHandler {\n\t/**\n\t * The short form version of the context ID, should be unique enough to partition data.\n\t * @param value The full context ID value.\n\t * @returns The short form version of the context ID.\n\t */\n\tshort?(value: string): string;\n\n\t/**\n\t * Performs a runtime guard on the provided context ID value.\n\t * @param value The context ID value to guard.\n\t * @throws Guard error if the value is invalid.\n\t */\n\tguard?(value: string): void;\n}\n"]}
+{"version":3,"file":"IContextIdHandler.js","sourceRoot":"","sources":["../../../src/models/IContextIdHandler.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\n\n/**\n * Interface describing a context ID handler.\n */\nexport interface IContextIdHandler extends IComponent {\n\t/**\n\t * The short form version of the context ID, should be unique enough to partition data.\n\t * @param value The full context ID value.\n\t * @returns The short form version of the context ID.\n\t */\n\tshort?(value: string): string;\n\n\t/**\n\t * Performs a runtime guard on the provided context ID value.\n\t * @param value The context ID value to guard.\n\t * @throws Guard error if the value is invalid.\n\t */\n\tguard?(value: string): void;\n}\n"]}

package/dist/es/utils/contextIdStore.js

@@ -1,4 +1,4 @@
-import { BaseError, GeneralError } from "@twin.org/core";
+import { BaseError, GeneralError, Is, SharedStore } from "@twin.org/core";
 /**
  * Class to maintain context ids and execute an async method.
  */
@@ -7,10 +7,6 @@ export class ContextIdStore {
      * Runtime name for the class.
      */
     static CLASS_NAME = "ContextIdStore";
-    /**
-     * The async local storage for the context ids.
-     */
-    static _storage;
     /**
      * Execute the method wrapped in the context.
      * @param contextIds The context IDs.
@@ -18,32 +14,37 @@ export class ContextIdStore {
      * @returns Nothing.
      */
     static async run(contextIds, asyncMethod) {
-        return (await ContextIdStore.createStorage()).run(contextIds, asyncMethod);
+        const storage = await ContextIdStore.getStorage();
+        return storage.run(contextIds, asyncMethod);
     }
     /**
      * Get the context IDs.
      * @returns The context IDs.
      */
     static async getContextIds() {
-        return (await ContextIdStore.createStorage()).getStore();
+        const storage = await ContextIdStore.getStorage();
+        return storage.getStore();
     }
     /**
-     * Create the storage if it doesn't exist.
+     * Get the storage and create it if it doesn't exist.
      * @returns The storage.
      */
-    static async createStorage() {
-        if (!ContextIdStore._storage) {
+    static async getStorage() {
+        let asyncHooksStore = SharedStore.get("asyncHooks");
+        if (Is.empty(asyncHooksStore?.contextIds)) {
             try {
                 const hooks = await import("node:async_hooks");
-                ContextIdStore._storage = new hooks.AsyncLocalStorage({
+                asyncHooksStore = asyncHooksStore ?? {};
+                asyncHooksStore.contextIds = new hooks.AsyncLocalStorage({
                     name: "AsyncContextIdsStorage"
                 });
             }
             catch (err) {
                 throw new GeneralError(ContextIdStore.CLASS_NAME, "asyncHooksNotAvailable", undefined, BaseError.fromError(err));
             }
+            SharedStore.set("asyncHooks", asyncHooksStore);
         }
-        return ContextIdStore._storage;
+        return asyncHooksStore.contextIds;
     }
 }
 //# sourceMappingURL=contextIdStore.js.map

package/dist/es/utils/contextIdStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextIdStore.js","sourceRoot":"","sources":["../../../src/utils/contextIdStore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIzD;;GAEG;AACH,MAAM,OAAO,cAAc;IAC1B;;OAEG;IACI,MAAM,CAAU,UAAU,oBAAoC;IAErE;;OAEG;IACK,MAAM,CAAC,QAAQ,CAAiC;IAExD;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAc,UAAuB,EAAE,WAAoB;QACjF,OAAO,CAAC,MAAM,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,CAAI,UAAU,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa;QAChC,OAAO,CAAC,MAAM,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,aAAa;QACjC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAC/C,cAAc,CAAC,QAAQ,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAc;oBAClE,IAAI,EAAE,wBAAwB;iBAC9B,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,YAAY,CACrB,cAAc,CAAC,UAAU,EACzB,wBAAwB,EACxB,SAAS,EACT,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CACxB,CAAC;YACH,CAAC;QACF,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IAChC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { AsyncLocalStorage } from \"node:async_hooks\";\nimport { BaseError, GeneralError } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport type { IContextIds } from \"../models/IContextIds.js\";\n\n/**\n * Class to maintain context ids and execute an async method.\n */\nexport class ContextIdStore {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<ContextIdStore>();\n\n\t/**\n\t * The async local storage for the context ids.\n\t */\n\tprivate static _storage: AsyncLocalStorage<IContextIds>;\n\n\t/**\n\t * Execute the method wrapped in the context.\n\t * @param contextIds The context IDs.\n\t * @param asyncMethod The async method to run.\n\t * @returns Nothing.\n\t */\n\tpublic static async run<T = unknown>(contextIds: IContextIds, asyncMethod: () => T): Promise<T> {\n\t\treturn (await ContextIdStore.createStorage()).run<T>(contextIds, asyncMethod);\n\t}\n\n\t/**\n\t * Get the context IDs.\n\t * @returns The context IDs.\n\t */\n\tpublic static async getContextIds(): Promise<IContextIds | undefined> {\n\t\treturn (await ContextIdStore.createStorage()).getStore();\n\t}\n\n\t/**\n\t * Create the storage if it doesn't exist.\n\t * @returns The storage.\n\t */\n\tprivate static async createStorage(): Promise<AsyncLocalStorage<IContextIds>> {\n\t\tif (!ContextIdStore._storage) {\n\t\t\ttry {\n\t\t\t\tconst hooks = await import(\"node:async_hooks\");\n\t\t\t\tContextIdStore._storage = new hooks.AsyncLocalStorage<IContextIds>({\n\t\t\t\t\tname: \"AsyncContextIdsStorage\"\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\tthrow new GeneralError(\n\t\t\t\t\tContextIdStore.CLASS_NAME,\n\t\t\t\t\t\"asyncHooksNotAvailable\",\n\t\t\t\t\tundefined,\n\t\t\t\t\tBaseError.fromError(err)\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\treturn ContextIdStore._storage;\n\t}\n}\n"]}
+{"version":3,"file":"contextIdStore.js","sourceRoot":"","sources":["../../../src/utils/contextIdStore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI1E;;GAEG;AACH,MAAM,OAAO,cAAc;IAC1B;;OAEG;IACI,MAAM,CAAU,UAAU,oBAAoC;IAErE;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAc,UAAuB,EAAE,WAAoB;QACjF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,GAAG,CAAI,UAAU,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa;QAChC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU;QAC7B,IAAI,eAAe,GAAG,WAAW,CAAC,GAAG,CACpC,YAAY,CACZ,CAAC;QAEF,IAAI,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAC/C,eAAe,GAAG,eAAe,IAAI,EAAE,CAAC;gBACxC,eAAe,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAc;oBACrE,IAAI,EAAE,wBAAwB;iBAC9B,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,YAAY,CACrB,cAAc,CAAC,UAAU,EACzB,wBAAwB,EACxB,SAAS,EACT,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CACxB,CAAC;YACH,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,eAAe,CAAC,UAAU,CAAC;IACnC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { AsyncLocalStorage } from \"node:async_hooks\";\nimport { BaseError, GeneralError, Is, SharedStore } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport type { IContextIds } from \"../models/IContextIds.js\";\n\n/**\n * Class to maintain context ids and execute an async method.\n */\nexport class ContextIdStore {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<ContextIdStore>();\n\n\t/**\n\t * Execute the method wrapped in the context.\n\t * @param contextIds The context IDs.\n\t * @param asyncMethod The async method to run.\n\t * @returns Nothing.\n\t */\n\tpublic static async run<T = unknown>(contextIds: IContextIds, asyncMethod: () => T): Promise<T> {\n\t\tconst storage = await ContextIdStore.getStorage();\n\t\treturn storage.run<T>(contextIds, asyncMethod);\n\t}\n\n\t/**\n\t * Get the context IDs.\n\t * @returns The context IDs.\n\t */\n\tpublic static async getContextIds(): Promise<IContextIds | undefined> {\n\t\tconst storage = await ContextIdStore.getStorage();\n\t\treturn storage.getStore();\n\t}\n\n\t/**\n\t * Get the storage and create it if it doesn't exist.\n\t * @returns The storage.\n\t */\n\tpublic static async getStorage(): Promise<AsyncLocalStorage<IContextIds>> {\n\t\tlet asyncHooksStore = SharedStore.get<{ contextIds?: AsyncLocalStorage<IContextIds> }>(\n\t\t\t\"asyncHooks\"\n\t\t);\n\n\t\tif (Is.empty(asyncHooksStore?.contextIds)) {\n\t\t\ttry {\n\t\t\t\tconst hooks = await import(\"node:async_hooks\");\n\t\t\t\tasyncHooksStore = asyncHooksStore ?? {};\n\t\t\t\tasyncHooksStore.contextIds = new hooks.AsyncLocalStorage<IContextIds>({\n\t\t\t\t\tname: \"AsyncContextIdsStorage\"\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\tthrow new GeneralError(\n\t\t\t\t\tContextIdStore.CLASS_NAME,\n\t\t\t\t\t\"asyncHooksNotAvailable\",\n\t\t\t\t\tundefined,\n\t\t\t\t\tBaseError.fromError(err)\n\t\t\t\t);\n\t\t\t}\n\t\t\tSharedStore.set(\"asyncHooks\", asyncHooksStore);\n\t\t}\n\t\treturn asyncHooksStore.contextIds;\n\t}\n}\n"]}

package/dist/types/models/IContextIdHandler.d.ts

@@ -1,7 +1,8 @@
+import type { IComponent } from "@twin.org/core";
 /**
  * Interface describing a context ID handler.
  */
-export interface IContextIdHandler {
+export interface IContextIdHandler extends IComponent {
     /**
      * The short form version of the context ID, should be unique enough to partition data.
      * @param value The full context ID value.

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

@@ -1,3 +1,4 @@
+import type { AsyncLocalStorage } from "node:async_hooks";
 import type { IContextIds } from "../models/IContextIds.js";
 /**
  * Class to maintain context ids and execute an async method.
@@ -7,10 +8,6 @@ export declare class ContextIdStore {
      * Runtime name for the class.
      */
     static readonly CLASS_NAME: string;
-    /**
-     * The async local storage for the context ids.
-     */
-    private static _storage;
     /**
      * Execute the method wrapped in the context.
      * @param contextIds The context IDs.
@@ -24,8 +21,8 @@ export declare class ContextIdStore {
      */
     static getContextIds(): Promise<IContextIds | undefined>;
     /**
-     * Create the storage if it doesn't exist.
+     * Get the storage and create it if it doesn't exist.
      * @returns The storage.
      */
-    private static createStorage;
+    static getStorage(): Promise<AsyncLocalStorage<IContextIds>>;
 }

package/docs/changelog.md

@@ -1,5 +1,552 @@
 # Changelog
 
+## [0.0.3-next.31](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.30...context-v0.0.3-next.31) (2026-04-14)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.30 to 0.0.3-next.31
+    * @twin.org/nameof bumped from 0.0.3-next.30 to 0.0.3-next.31
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.30 to 0.0.3-next.31
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.30 to 0.0.3-next.31
+    * @twin.org/validate-locales bumped from 0.0.3-next.30 to 0.0.3-next.31
+
+## [0.0.3-next.30](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.29...context-v0.0.3-next.30) (2026-04-14)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.29 to 0.0.3-next.30
+    * @twin.org/nameof bumped from 0.0.3-next.29 to 0.0.3-next.30
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.29 to 0.0.3-next.30
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.29 to 0.0.3-next.30
+    * @twin.org/validate-locales bumped from 0.0.3-next.29 to 0.0.3-next.30
+
+## [0.0.3-next.29](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.28...context-v0.0.3-next.29) (2026-04-14)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.28 to 0.0.3-next.29
+    * @twin.org/nameof bumped from 0.0.3-next.28 to 0.0.3-next.29
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.28 to 0.0.3-next.29
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.28 to 0.0.3-next.29
+    * @twin.org/validate-locales bumped from 0.0.3-next.28 to 0.0.3-next.29
+
+## [0.0.3-next.28](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.27...context-v0.0.3-next.28) (2026-03-27)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.27 to 0.0.3-next.28
+    * @twin.org/nameof bumped from 0.0.3-next.27 to 0.0.3-next.28
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.27 to 0.0.3-next.28
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.27 to 0.0.3-next.28
+    * @twin.org/validate-locales bumped from 0.0.3-next.27 to 0.0.3-next.28
+
+## [0.0.3-next.27](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.26...context-v0.0.3-next.27) (2026-03-27)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.26 to 0.0.3-next.27
+    * @twin.org/nameof bumped from 0.0.3-next.26 to 0.0.3-next.27
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.26 to 0.0.3-next.27
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.26 to 0.0.3-next.27
+    * @twin.org/validate-locales bumped from 0.0.3-next.26 to 0.0.3-next.27
+
+## [0.0.3-next.26](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.25...context-v0.0.3-next.26) (2026-03-24)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.25 to 0.0.3-next.26
+    * @twin.org/nameof bumped from 0.0.3-next.25 to 0.0.3-next.26
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.25 to 0.0.3-next.26
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.25 to 0.0.3-next.26
+    * @twin.org/validate-locales bumped from 0.0.3-next.25 to 0.0.3-next.26
+
+## [0.0.3-next.25](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.24...context-v0.0.3-next.25) (2026-03-23)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.24 to 0.0.3-next.25
+    * @twin.org/nameof bumped from 0.0.3-next.24 to 0.0.3-next.25
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.24 to 0.0.3-next.25
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.24 to 0.0.3-next.25
+    * @twin.org/validate-locales bumped from 0.0.3-next.24 to 0.0.3-next.25
+
+## [0.0.3-next.24](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.23...context-v0.0.3-next.24) (2026-03-19)
+
+
+### Bug Fixes
+
+* ensure __decorate is defined for decorators ([103a563](https://github.com/twinfoundation/framework/commit/103a563ce01ebdef6240d2e590e7b026e8692684))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.23 to 0.0.3-next.24
+    * @twin.org/nameof bumped from 0.0.3-next.23 to 0.0.3-next.24
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.23 to 0.0.3-next.24
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.23 to 0.0.3-next.24
+    * @twin.org/validate-locales bumped from 0.0.3-next.23 to 0.0.3-next.24
+
+## [0.0.3-next.23](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.22...context-v0.0.3-next.23) (2026-03-17)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/nameof bumped from 0.0.3-next.22 to 0.0.3-next.23
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/validate-locales bumped from 0.0.3-next.22 to 0.0.3-next.23
+
+## [0.0.3-next.22](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.21...context-v0.0.3-next.22) (2026-02-26)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/nameof bumped from 0.0.3-next.21 to 0.0.3-next.22
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/validate-locales bumped from 0.0.3-next.21 to 0.0.3-next.22
+
+## [0.0.3-next.21](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.20...context-v0.0.3-next.21) (2026-02-26)
+
+
+### Features
+
+* add context id features ([#206](https://github.com/twinfoundation/framework/issues/206)) ([ef0d4ee](https://github.com/twinfoundation/framework/commit/ef0d4ee11a4f5fc6cc6f52a4958ce905c04ee13b))
+* context id handler derives from component ([c868ec2](https://github.com/twinfoundation/framework/commit/c868ec21d3a576d4faa222bf130270a21936e50e))
+
+
+### Bug Fixes
+
+* use singleton pattern for context storage ([c69f358](https://github.com/twinfoundation/framework/commit/c69f358e45361b45d4e46f19846cd5b8c99b0ccd))
+* use singleton pattern for context storage ([5cc706a](https://github.com/twinfoundation/framework/commit/5cc706a2bbfc601fa3d00f3efd8b764052e9f91d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.20 to 0.0.3-next.21
+    * @twin.org/nameof bumped from 0.0.3-next.20 to 0.0.3-next.21
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.20 to 0.0.3-next.21
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.20 to 0.0.3-next.21
+    * @twin.org/validate-locales bumped from 0.0.3-next.20 to 0.0.3-next.21
+
+## [0.0.3-next.20](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.19...context-v0.0.3-next.20) (2026-02-26)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.19 to 0.0.3-next.20
+    * @twin.org/nameof bumped from 0.0.3-next.19 to 0.0.3-next.20
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.19 to 0.0.3-next.20
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.19 to 0.0.3-next.20
+    * @twin.org/validate-locales bumped from 0.0.3-next.19 to 0.0.3-next.20
+
+## [0.0.3-next.19](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.18...context-v0.0.3-next.19) (2026-02-26)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.18 to 0.0.3-next.19
+    * @twin.org/nameof bumped from 0.0.3-next.18 to 0.0.3-next.19
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.18 to 0.0.3-next.19
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.18 to 0.0.3-next.19
+    * @twin.org/validate-locales bumped from 0.0.3-next.18 to 0.0.3-next.19
+
+## [0.0.3-next.18](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.17...context-v0.0.3-next.18) (2026-02-23)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.17 to 0.0.3-next.18
+    * @twin.org/nameof bumped from 0.0.3-next.17 to 0.0.3-next.18
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.17 to 0.0.3-next.18
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.17 to 0.0.3-next.18
+    * @twin.org/validate-locales bumped from 0.0.3-next.17 to 0.0.3-next.18
+
+## [0.0.3-next.17](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.16...context-v0.0.3-next.17) (2026-02-09)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.16 to 0.0.3-next.17
+    * @twin.org/nameof bumped from 0.0.3-next.16 to 0.0.3-next.17
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.16 to 0.0.3-next.17
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.16 to 0.0.3-next.17
+    * @twin.org/validate-locales bumped from 0.0.3-next.16 to 0.0.3-next.17
+
+## [0.0.3-next.16](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.15...context-v0.0.3-next.16) (2026-02-06)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.15 to 0.0.3-next.16
+    * @twin.org/nameof bumped from 0.0.3-next.15 to 0.0.3-next.16
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.15 to 0.0.3-next.16
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.15 to 0.0.3-next.16
+    * @twin.org/validate-locales bumped from 0.0.3-next.15 to 0.0.3-next.16
+
+## [0.0.3-next.15](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.14...context-v0.0.3-next.15) (2026-01-29)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.14 to 0.0.3-next.15
+    * @twin.org/nameof bumped from 0.0.3-next.14 to 0.0.3-next.15
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.14 to 0.0.3-next.15
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.14 to 0.0.3-next.15
+    * @twin.org/validate-locales bumped from 0.0.3-next.14 to 0.0.3-next.15
+
+## [0.0.3-next.14](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.13...context-v0.0.3-next.14) (2026-01-22)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.13 to 0.0.3-next.14
+    * @twin.org/nameof bumped from 0.0.3-next.13 to 0.0.3-next.14
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.13 to 0.0.3-next.14
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.13 to 0.0.3-next.14
+    * @twin.org/validate-locales bumped from 0.0.3-next.13 to 0.0.3-next.14
+
+## [0.0.3-next.13](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.12...context-v0.0.3-next.13) (2026-01-08)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.12 to 0.0.3-next.13
+    * @twin.org/nameof bumped from 0.0.3-next.12 to 0.0.3-next.13
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.12 to 0.0.3-next.13
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.12 to 0.0.3-next.13
+    * @twin.org/validate-locales bumped from 0.0.3-next.12 to 0.0.3-next.13
+
+## [0.0.3-next.12](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.11...context-v0.0.3-next.12) (2026-01-08)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.11 to 0.0.3-next.12
+    * @twin.org/nameof bumped from 0.0.3-next.11 to 0.0.3-next.12
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.11 to 0.0.3-next.12
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.11 to 0.0.3-next.12
+    * @twin.org/validate-locales bumped from 0.0.3-next.11 to 0.0.3-next.12
+
+## [0.0.3-next.11](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.10...context-v0.0.3-next.11) (2026-01-07)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.10 to 0.0.3-next.11
+    * @twin.org/nameof bumped from 0.0.3-next.10 to 0.0.3-next.11
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.10 to 0.0.3-next.11
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.10 to 0.0.3-next.11
+    * @twin.org/validate-locales bumped from 0.0.3-next.10 to 0.0.3-next.11
+
+## [0.0.3-next.10](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.9...context-v0.0.3-next.10) (2026-01-07)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.9 to 0.0.3-next.10
+    * @twin.org/nameof bumped from 0.0.3-next.9 to 0.0.3-next.10
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.9 to 0.0.3-next.10
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.9 to 0.0.3-next.10
+    * @twin.org/validate-locales bumped from 0.0.3-next.9 to 0.0.3-next.10
+
+## [0.0.3-next.9](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.8...context-v0.0.3-next.9) (2026-01-05)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.8 to 0.0.3-next.9
+    * @twin.org/nameof bumped from 0.0.3-next.8 to 0.0.3-next.9
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.8 to 0.0.3-next.9
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.8 to 0.0.3-next.9
+    * @twin.org/validate-locales bumped from 0.0.3-next.8 to 0.0.3-next.9
+
+## [0.0.3-next.8](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.7...context-v0.0.3-next.8) (2025-11-26)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.7 to 0.0.3-next.8
+    * @twin.org/nameof bumped from 0.0.3-next.7 to 0.0.3-next.8
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.7 to 0.0.3-next.8
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.7 to 0.0.3-next.8
+    * @twin.org/validate-locales bumped from 0.0.3-next.7 to 0.0.3-next.8
+
+## [0.0.3-next.7](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.6...context-v0.0.3-next.7) (2025-11-25)
+
+
+### Features
+
+* add context id features ([#206](https://github.com/twinfoundation/framework/issues/206)) ([ef0d4ee](https://github.com/twinfoundation/framework/commit/ef0d4ee11a4f5fc6cc6f52a4958ce905c04ee13b))
+* context id handler derives from component ([c868ec2](https://github.com/twinfoundation/framework/commit/c868ec21d3a576d4faa222bf130270a21936e50e))
+
+
+### Bug Fixes
+
+* use singleton pattern for context storage ([c69f358](https://github.com/twinfoundation/framework/commit/c69f358e45361b45d4e46f19846cd5b8c99b0ccd))
+* use singleton pattern for context storage ([5cc706a](https://github.com/twinfoundation/framework/commit/5cc706a2bbfc601fa3d00f3efd8b764052e9f91d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.6 to 0.0.3-next.7
+    * @twin.org/nameof bumped from 0.0.3-next.6 to 0.0.3-next.7
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.6 to 0.0.3-next.7
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.6 to 0.0.3-next.7
+    * @twin.org/validate-locales bumped from 0.0.3-next.6 to 0.0.3-next.7
+
+## [0.0.3-next.6](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.5...context-v0.0.3-next.6) (2025-11-25)
+
+
+### Miscellaneous Chores
+
+* **context:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.5 to 0.0.3-next.6
+    * @twin.org/nameof bumped from 0.0.3-next.5 to 0.0.3-next.6
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.5 to 0.0.3-next.6
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.5 to 0.0.3-next.6
+    * @twin.org/validate-locales bumped from 0.0.3-next.5 to 0.0.3-next.6
+
+## [0.0.3-next.5](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.4...context-v0.0.3-next.5) (2025-11-20)
+
+
+### Features
+
+* context id handler derives from component ([c868ec2](https://github.com/twinfoundation/framework/commit/c868ec21d3a576d4faa222bf130270a21936e50e))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.4 to 0.0.3-next.5
+    * @twin.org/nameof bumped from 0.0.3-next.4 to 0.0.3-next.5
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.4 to 0.0.3-next.5
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.4 to 0.0.3-next.5
+    * @twin.org/validate-locales bumped from 0.0.3-next.4 to 0.0.3-next.5
+
+## [0.0.3-next.4](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.3...context-v0.0.3-next.4) (2025-11-13)
+
+
+### Bug Fixes
+
+* use singleton pattern for context storage ([c69f358](https://github.com/twinfoundation/framework/commit/c69f358e45361b45d4e46f19846cd5b8c99b0ccd))
+* use singleton pattern for context storage ([5cc706a](https://github.com/twinfoundation/framework/commit/5cc706a2bbfc601fa3d00f3efd8b764052e9f91d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.3 to 0.0.3-next.4
+    * @twin.org/nameof bumped from 0.0.3-next.3 to 0.0.3-next.4
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.3 to 0.0.3-next.4
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.3 to 0.0.3-next.4
+    * @twin.org/validate-locales bumped from 0.0.3-next.3 to 0.0.3-next.4
+
 ## [0.0.3-next.3](https://github.com/twinfoundation/framework/compare/context-v0.0.3-next.2...context-v0.0.3-next.3) (2025-11-12)
 
 
@@ -57,4 +604,4 @@
     * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.0 to 0.0.3-next.1
     * @twin.org/validate-locales bumped from 0.0.3-next.0 to 0.0.3-next.1
 
-## @twin.org/context - Changelog
+## Changelog

package/docs/examples.md

@@ -1 +1,57 @@
-# @twin.org/context - Examples
+# Context Examples
+
+Use these snippets to keep trace identifiers consistent across asynchronous operations and service boundaries.
+
+## ContextIdHelper
+
+```typescript
+import { ContextIdHelper } from '@twin.org/context';
+
+const traceContext = {
+  traceId: 'trc-0011223344556677',
+  spanId: 'spn-9a8b7c6d5e4f3210'
+};
+
+ContextIdHelper.short(traceContext.traceId); // '0011223344556677'
+ContextIdHelper.shortAll(traceContext); // { traceId: '0011223344556677', spanId: '9a8b7c6d5e4f3210' }
+```
+
+```typescript
+import { ContextIdHelper } from '@twin.org/context';
+
+const contextIds = {
+  traceId: 'trace-1234',
+  spanId: 'span-5678',
+  requestId: 'req-90ab'
+};
+
+const combined = ContextIdHelper.shortCombined(contextIds); // '1234:5678:90ab'
+ContextIdHelper.shortSplit(combined); // ['1234', '5678', '90ab']
+```
+
+## ContextIdStore
+
+```typescript
+import { ContextIdStore } from '@twin.org/context';
+
+await ContextIdStore.run({ traceId: 'trc-01', spanId: 'spn-02' }, async () => {
+  ContextIdStore.getContextIds(); // { traceId: 'trc-01', spanId: 'spn-02' }
+});
+```
+
+## ContextIdHandlerFactory
+
+```typescript
+import { ContextIdHandlerFactory } from '@twin.org/context';
+import type { IContextIdHandler } from '@twin.org/context';
+
+class RequestContextHandler implements IContextIdHandler {
+  public getContextIds() {
+    return { traceId: 'trc-1001', spanId: 'spn-2002' };
+  }
+}
+
+ContextIdHandlerFactory.register('request', () => new RequestContextHandler());
+const handler = ContextIdHandlerFactory.create('request');
+handler.getContextIds().traceId; // 'trc-1001'
+```

package/docs/reference/classes/ContextIdHelper.md

@@ -14,7 +14,7 @@ Class to help with context IDs.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -22,7 +22,7 @@ Runtime name for the class.
 
 ## Methods
 
-### guard()
+### guard() {#guard}
 
 > `static` **guard**\<`T`, `K`\>(`contextIds`, `key`): `asserts contextIds is T & { [P in string]: string }`
 
@@ -42,9 +42,9 @@ Perform a runtime guard on the provided context ID value.
 
 ##### contextIds
 
-The context IDs to guard.
+`T` \| `undefined`
 
-`T` | `undefined`
+The context IDs to guard.
 
 ##### key
 
@@ -62,7 +62,7 @@ Guard error if the value is invalid.
 
 ***
 
-### short()
+### short() {#short}
 
 > `static` **short**(`contextIds`, `key`): `string`
 
@@ -72,9 +72,9 @@ Gets the short version of a context ID.
 
 ##### contextIds
 
-The context IDs to get the short version from.
+[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`
 
-[`IContextIds`](../interfaces/IContextIds.md) | `undefined`
+The context IDs to get the short version from.
 
 ##### key
 
@@ -94,7 +94,7 @@ Guard error if the value is invalid.
 
 ***
 
-### guardAll()
+### guardAll() {#guardall}
 
 > `static` **guardAll**\<`T`, `K`\>(`contextIds`, `keys`): `asserts contextIds is T & { [P in string]: string }`
 
@@ -114,15 +114,15 @@ Perform a runtime guard on the provided context ID values.
 
 ##### contextIds
 
-The context IDs to guard.
+`T` \| `undefined`
 
-`T` | `undefined`
+The context IDs to guard.
 
 ##### keys
 
-The context ID keys to guard.
+readonly `K`[] \| `undefined`
 
-readonly `K`[] | `undefined`
+The context ID keys to guard.
 
 #### Returns
 
@@ -134,7 +134,7 @@ Guard error if the value is invalid.
 
 ***
 
-### shortAll()
+### shortAll() {#shortall}
 
 > `static` **shortAll**(`contextIds`, `keys`): [`IContextIds`](../interfaces/IContextIds.md)
 
@@ -144,15 +144,15 @@ Gets the short versions of multiple context IDs.
 
 ##### contextIds
 
-The context IDs to get the short versions from.
+[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`
 
-[`IContextIds`](../interfaces/IContextIds.md) | `undefined`
+The context IDs to get the short versions from.
 
 ##### keys
 
-The context ID keys to get the short versions for.
+`string`[] \| `undefined`
 
-`string`[] | `undefined`
+The context ID keys to get the short versions for.
 
 #### Returns
 
@@ -162,9 +162,9 @@ The short versions of the context IDs.
 
 ***
 
-### shortCombined()
+### shortCombined() {#shortcombined}
 
-> `static` **shortCombined**(`contextIds`, `keys`, `separator`): `string` \| `undefined`
+> `static` **shortCombined**(`contextIds`, `keys`, `separator?`): `string` \| `undefined`
 
 Gets the combined short version.
 
@@ -172,17 +172,17 @@ Gets the combined short version.
 
 ##### contextIds
 
-The context IDs to get the short versions from.
+[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`
 
-[`IContextIds`](../interfaces/IContextIds.md) | `undefined`
+The context IDs to get the short versions from.
 
 ##### keys
 
-The context ID keys to get the short versions for.
+`string`[] \| `undefined`
 
-`string`[] | `undefined`
+The context ID keys to get the short versions for.
 
-##### separator
+##### separator?
 
 `string` = `"/"`
 
@@ -196,9 +196,9 @@ The short version combined.
 
 ***
 
-### shortSplit()
+### shortSplit() {#shortsplit}
 
-> `static` **shortSplit**(`keys`, `combined`, `separator`): [`IContextIds`](../interfaces/IContextIds.md)
+> `static` **shortSplit**(`keys`, `combined`, `separator?`): [`IContextIds`](../interfaces/IContextIds.md)
 
 Split a combined short version in to the separate context IDs.
 
@@ -216,7 +216,7 @@ The context ID keys to get the short versions for.
 
 The combined short version to separate.
 
-##### separator
+##### separator?
 
 `string` = `"/"`
 
@@ -234,9 +234,9 @@ GeneralError if the number of parts does not match the number of keys.
 
 ***
 
-### combinedContextKey()
+### combinedContextKey() {#combinedcontextkey}
 
-> `static` **combinedContextKey**(`contextIds`, `keys`, `separator`): `string` \| `undefined`
+> `static` **combinedContextKey**(`contextIds`, `keys`, `separator?`): `string` \| `undefined`
 
 Create a combined key.
 
@@ -244,17 +244,17 @@ Create a combined key.
 
 ##### contextIds
 
-The context IDs to create the combined key for.
+[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`
 
-[`IContextIds`](../interfaces/IContextIds.md) | `undefined`
+The context IDs to create the combined key for.
 
 ##### keys
 
-The context ID keys to get the short versions for.
+`string`[] \| `undefined`
 
-`string`[] | `undefined`
+The context ID keys to get the short versions for.
 
-##### separator
+##### separator?
 
 `string` = `"/"`
 
@@ -268,7 +268,7 @@ The short version combined.
 
 ***
 
-### pickKeysFromAvailable()
+### pickKeysFromAvailable() {#pickkeysfromavailable}
 
 > `static` **pickKeysFromAvailable**(`availableKeys?`, `desiredKeys?`): `string`[]
 

package/docs/reference/classes/ContextIdStore.md

@@ -14,7 +14,7 @@ Class to maintain context ids and execute an async method.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -22,7 +22,7 @@ Runtime name for the class.
 
 ## Methods
 
-### run()
+### run() {#run}
 
 > `static` **run**\<`T`\>(`contextIds`, `asyncMethod`): `Promise`\<`T`\>
 
@@ -56,7 +56,7 @@ Nothing.
 
 ***
 
-### getContextIds()
+### getContextIds() {#getcontextids}
 
 > `static` **getContextIds**(): `Promise`\<[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`\>
 
@@ -67,3 +67,17 @@ Get the context IDs.
 `Promise`\<[`IContextIds`](../interfaces/IContextIds.md) \| `undefined`\>
 
 The context IDs.
+
+***
+
+### getStorage() {#getstorage}
+
+> `static` **getStorage**(): `Promise`\<`AsyncLocalStorage`\<[`IContextIds`](../interfaces/IContextIds.md)\>\>
+
+Get the storage and create it if it doesn't exist.
+
+#### Returns
+
+`Promise`\<`AsyncLocalStorage`\<[`IContextIds`](../interfaces/IContextIds.md)\>\>
+
+The storage.

package/docs/reference/interfaces/IContextIdHandler.md

@@ -2,9 +2,13 @@
 
 Interface describing a context ID handler.
 
+## Extends
+
+- `IComponent`
+
 ## Methods
 
-### short()?
+### short()? {#short}
 
 > `optional` **short**(`value`): `string`
 
@@ -26,7 +30,7 @@ The short form version of the context ID.
 
 ***
 
-### guard()?
+### guard()? {#guard}
 
 > `optional` **guard**(`value`): `void`
 
@@ -47,3 +51,99 @@ The context ID value to guard.
 #### Throws
 
 Guard error if the value is invalid.
+
+***
+
+### className() {#classname}
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Inherited from
+
+`IComponent.className`
+
+***
+
+### bootstrap()? {#bootstrap}
+
+> `optional` **bootstrap**(`nodeLoggingComponentType?`): `Promise`\<`boolean`\>
+
+Bootstrap the component by creating and initializing any resources it needs.
+
+#### Parameters
+
+##### nodeLoggingComponentType?
+
+`string`
+
+The node logging component type.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+True if the bootstrapping process was successful.
+
+#### Inherited from
+
+`IComponent.bootstrap`
+
+***
+
+### start()? {#start}
+
+> `optional` **start**(`nodeLoggingComponentType?`): `Promise`\<`void`\>
+
+The component needs to be started when the node is initialized.
+
+#### Parameters
+
+##### nodeLoggingComponentType?
+
+`string`
+
+The node logging component type.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Inherited from
+
+`IComponent.start`
+
+***
+
+### stop()? {#stop}
+
+> `optional` **stop**(`nodeLoggingComponentType?`): `Promise`\<`void`\>
+
+The component needs to be stopped when the node is closed.
+
+#### Parameters
+
+##### nodeLoggingComponentType?
+
+`string`
+
+The node logging component type.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Inherited from
+
+`IComponent.stop`

package/docs/reference/interfaces/IContextIds.md

@@ -4,6 +4,6 @@ Interface describing context ids which can be accessed async from a request.
 
 ## Indexable
 
-\[`id`: `string`\]: `string` \| `undefined`
+> \[`id`: `string`\]: `string` \| `undefined`
 
 The context id keys and values.

package/docs/reference/variables/ContextIdKeys.md

@@ -6,25 +6,25 @@ Default definition of some context keys.
 
 ## Type Declaration
 
-### Node
+### Node {#node}
 
 > `readonly` **Node**: `"node"` = `"node"`
 
 Standard property type definition for node.
 
-### Tenant
+### Tenant {#tenant}
 
 > `readonly` **Tenant**: `"tenant"` = `"tenant"`
 
 Standard property type definition for tenant.
 
-### Organization
+### Organization {#organization}
 
 > `readonly` **Organization**: `"organization"` = `"organization"`
 
 Standard property type definition for organization.
 
-### User
+### User {#user}
 
 > `readonly` **User**: `"user"` = `"user"`
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/context",
-	"version": "0.0.3-next.3",
+	"version": "0.0.3-next.31",
 	"description": "Helper methods/classes for context handling",
 	"repository": {
 		"type": "git",
@@ -14,8 +14,8 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "0.0.3-next.3",
-		"@twin.org/nameof": "0.0.3-next.3"
+		"@twin.org/core": "0.0.3-next.31",
+		"@twin.org/nameof": "0.0.3-next.31"
 	},
 	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",