@twin.org/core 0.0.2-next.4 → 0.0.2-next.6

package/dist/types/errors/conflictError.d.ts

@@ -13,7 +13,7 @@ export declare class ConflictError extends BaseError {
      * @param message The message as a code.
      * @param conflictId The id that has conflicts.
      * @param conflicts The conflicts that occurred.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause or the error if we have wrapped another error.
      */
-    constructor(source: string, message: string, conflictId?: string, conflicts?: string[], inner?: unknown);
+    constructor(source: string, message: string, conflictId?: string, conflicts?: string[], cause?: unknown);
 }

package/dist/types/errors/generalError.d.ts

@@ -12,9 +12,9 @@ export declare class GeneralError extends BaseError {
      * @param source The source of the error.
      * @param message The message as a code.
      * @param properties Any additional information for the error.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause of the error if we have wrapped another error.
      */
     constructor(source: string, message: string, properties?: {
         [id: string]: unknown;
-    }, inner?: unknown);
+    }, cause?: unknown);
 }

package/dist/types/errors/notFoundError.d.ts

@@ -12,7 +12,7 @@ export declare class NotFoundError extends BaseError {
      * @param source The source of the error.
      * @param message The message as a code.
      * @param notFoundId The id for the item.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause of the error if we have wrapped another error.
      */
-    constructor(source: string, message: string, notFoundId?: string, inner?: unknown);
+    constructor(source: string, message: string, notFoundId?: string, cause?: unknown);
 }

package/dist/types/errors/notSupportedError.d.ts

@@ -11,7 +11,7 @@ export declare class NotSupportedError extends BaseError {
      * Create a new instance of NotSupportedError.
      * @param source The source of the error.
      * @param message The message as a code.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause of the error if we have wrapped another error.
      */
-    constructor(source: string, message: string, inner?: unknown);
+    constructor(source: string, message: string, cause?: unknown);
 }

package/dist/types/errors/unauthorizedError.d.ts

@@ -11,7 +11,7 @@ export declare class UnauthorizedError extends BaseError {
      * Create a new instance of UnauthorizedError.
      * @param source The source of the error.
      * @param message The message as a code.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause of the error if we have wrapped another error.
      */
-    constructor(source: string, message: string, inner?: unknown);
+    constructor(source: string, message: string, cause?: unknown);
 }

package/dist/types/errors/unprocessableError.d.ts

@@ -12,9 +12,9 @@ export declare class UnprocessableError extends BaseError {
      * @param source The source of the error.
      * @param message The message as a code.
      * @param properties Any additional information for the error.
-     * @param inner The inner error if we have wrapped another error.
+     * @param cause The cause of the error if we have wrapped another error.
      */
     constructor(source: string, message: string, properties?: {
         [id: string]: unknown;
-    }, inner?: unknown);
+    }, cause?: unknown);
 }

package/dist/types/factories/factory.d.ts

@@ -51,7 +51,7 @@ export declare class Factory<T> {
      * @param name The name of the instance to generate.
      * @returns An instance of the item or undefined if it does not exist.
      */
-    getIfExists<U extends T>(name: string): U | undefined;
+    getIfExists<U extends T>(name?: string): U | undefined;
     /**
      * Remove all the instances and leave the generators intact.
      */

package/dist/types/helpers/errorHelper.d.ts

@@ -7,17 +7,17 @@ export declare class ErrorHelper {
      * Format Errors and returns just their messages.
      * @param error The error to format.
      * @param includeDetails Whether to include error details, defaults to false.
-     * @returns The error formatted including any inner errors.
+     * @returns The error formatted including any causes errors.
      */
     static formatErrors(error: unknown, includeDetails?: boolean): string[];
     /**
-     * Localize the content of an error and any inner errors.
+     * Localize the content of an error and any causes.
      * @param error The error to format.
      * @returns The localized version of the errors flattened.
      */
     static localizeErrors(error: unknown): IError[];
     /**
-     * Localize the content of an error and any inner errors.
+     * Localize the content of an error and any causes.
      * @param error The error to format.
      * @returns The localized version of the errors flattened.
      */

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

@@ -8,31 +8,22 @@ export interface IComponent {
     readonly CLASS_NAME: string;
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
-     * @param componentState A persistent state which can be modified by the method.
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns True if the bootstrapping process was successful.
      */
-    bootstrap?(nodeLoggingConnectorType: string | undefined, componentState?: {
-        [id: string]: unknown;
-    }): Promise<boolean>;
+    bootstrap?(nodeLoggingComponentType: string | undefined): Promise<boolean>;
     /**
      * The component needs to be started when the node is initialized.
      * @param nodeIdentity The identity of the node starting the component.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
-     * @param componentState A persistent state which can be modified by the method.
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns Nothing.
      */
-    start?(nodeIdentity: string, nodeLoggingConnectorType: string | undefined, componentState?: {
-        [id: string]: unknown;
-    }): Promise<void>;
+    start?(nodeIdentity: string, nodeLoggingComponentType: string | undefined): Promise<void>;
     /**
      * The component needs to be stopped when the node is closed.
      * @param nodeIdentity The identity of the node stopping the component.
-     * @param nodeLoggingConnectorType The node logging connector type, defaults to "node-logging".
-     * @param componentState A persistent state which can be modified by the method.
+     * @param nodeLoggingComponentType The node logging component type.
      * @returns Nothing.
      */
-    stop?(nodeIdentity: string, nodeLoggingConnectorType: string | undefined, componentState?: {
-        [id: string]: unknown;
-    }): Promise<void>;
+    stop?(nodeIdentity: string, nodeLoggingComponentType: string | undefined): Promise<void>;
 }

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

@@ -25,7 +25,7 @@ export interface IError {
      */
     stack?: string;
     /**
-     * The inner error if there was one.
+     * The cause of the error if there was one.
      */
-    inner?: IError;
+    cause?: IError;
 }

package/docs/changelog.md

@@ -1,5 +1,39 @@
 # @twin.org/core - Changelog
 
+## [0.0.2-next.6](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.5...core-v0.0.2-next.6) (2025-08-27)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.5 to 0.0.2-next.6
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.5 to 0.0.2-next.6
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.5 to 0.0.2-next.6
+
+## [0.0.2-next.5](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.4...core-v0.0.2-next.5) (2025-08-19)
+
+
+### Features
+
+* use cause instead of inner for errors ([1f4acc4](https://github.com/twinfoundation/framework/commit/1f4acc4d7a6b71a134d9547da9bf40de1e1e49da))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.4 to 0.0.2-next.5
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.4 to 0.0.2-next.5
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.4 to 0.0.2-next.5
+
 ## [0.0.2-next.4](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.3...core-v0.0.2-next.4) (2025-08-15)
 
 

package/docs/reference/classes/AlreadyExistsError.md

@@ -10,7 +10,7 @@ Class to handle errors which are triggered by data already existing.
 
 ### Constructor
 
-> **new AlreadyExistsError**(`source`, `message`, `existingId?`, `inner?`): `AlreadyExistsError`
+> **new AlreadyExistsError**(`source`, `message`, `existingId?`, `cause?`): `AlreadyExistsError`
 
 Create a new instance of AlreadyExistsError.
 
@@ -34,11 +34,11 @@ The message as a code.
 
 The id for the item.
 
-##### inner?
+##### cause?
 
 `unknown`
 
-The inner error if we have wrapped another error.
+The cause of the error if we have wrapped another error.
 
 #### Returns
 
@@ -86,15 +86,15 @@ Any additional information for the error.
 
 ***
 
-### inner?
+### cause?
 
-> `optional` **inner**: [`IError`](../interfaces/IError.md)
+> `optional` **cause**: [`IError`](../interfaces/IError.md)
 
-The inner error if there was one.
+The cause of the error.
 
 #### Inherited from
 
-[`BaseError`](BaseError.md).[`inner`](BaseError.md#inner)
+[`BaseError`](BaseError.md).[`cause`](BaseError.md#cause)
 
 ## Methods
 
@@ -404,7 +404,7 @@ True if the error has the name.
 
 > `static` **isEmpty**(`err`): `boolean`
 
-Is the error empty.
+Is the error empty, i.e. does it have no message, source, properties, or cause?
 
 #### Parameters
 
@@ -426,6 +426,64 @@ True if the error is empty.
 
 ***
 
+### isAggregateError()
+
+> `static` **isAggregateError**(`err`): `err is AggregateError`
+
+Is the error an aggregate error.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to check for being an aggregate error.
+
+#### Returns
+
+`err is AggregateError`
+
+True if the error is an aggregate error.
+
+#### Inherited from
+
+[`BaseError`](BaseError.md).[`isAggregateError`](BaseError.md#isaggregateerror)
+
+***
+
+### fromAggregate()
+
+> `static` **fromAggregate**(`err`, `includeStackTrace?`): [`IError`](../interfaces/IError.md)[]
+
+Convert the aggregate error to an array of errors.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to convert.
+
+##### includeStackTrace?
+
+`boolean`
+
+Whether to include the error stack in the model, defaults to false.
+
+#### Returns
+
+[`IError`](../interfaces/IError.md)[]
+
+The array of errors.
+
+#### Inherited from
+
+[`BaseError`](BaseError.md).[`fromAggregate`](BaseError.md#fromaggregate)
+
+***
+
 ### toJsonObject()
 
 > **toJsonObject**(`includeStackTrace?`): [`IError`](../interfaces/IError.md)

package/docs/reference/classes/BaseError.md

@@ -27,7 +27,7 @@ Class to handle errors.
 
 ### Constructor
 
-> **new BaseError**(`name`, `source`, `message`, `properties?`, `inner?`): `BaseError`
+> **new BaseError**(`name`, `source`, `message`, `properties?`, `cause?`): `BaseError`
 
 Create a new instance of BaseError.
 
@@ -55,11 +55,11 @@ The message as a code.
 
 Any additional information for the error.
 
-##### inner?
+##### cause?
 
 `unknown`
 
-The inner error if we have wrapped another error.
+The cause of error if we have wrapped another error.
 
 #### Returns
 
@@ -99,15 +99,19 @@ Any additional information for the error.
 
 ***
 
-### inner?
+### cause?
 
-> `optional` **inner**: [`IError`](../interfaces/IError.md)
+> `optional` **cause**: [`IError`](../interfaces/IError.md)
 
-The inner error if there was one.
+The cause of the error.
 
 #### Implementation of
 
-[`IError`](../interfaces/IError.md).[`inner`](../interfaces/IError.md#inner)
+[`IError`](../interfaces/IError.md).[`cause`](../interfaces/IError.md#cause)
+
+#### Overrides
+
+`Error.cause`
 
 ## Methods
 
@@ -377,7 +381,7 @@ True if the error has the name.
 
 > `static` **isEmpty**(`err`): `boolean`
 
-Is the error empty.
+Is the error empty, i.e. does it have no message, source, properties, or cause?
 
 #### Parameters
 
@@ -395,6 +399,56 @@ True if the error is empty.
 
 ***
 
+### isAggregateError()
+
+> `static` **isAggregateError**(`err`): `err is AggregateError`
+
+Is the error an aggregate error.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to check for being an aggregate error.
+
+#### Returns
+
+`err is AggregateError`
+
+True if the error is an aggregate error.
+
+***
+
+### fromAggregate()
+
+> `static` **fromAggregate**(`err`, `includeStackTrace?`): [`IError`](../interfaces/IError.md)[]
+
+Convert the aggregate error to an array of errors.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to convert.
+
+##### includeStackTrace?
+
+`boolean`
+
+Whether to include the error stack in the model, defaults to false.
+
+#### Returns
+
+[`IError`](../interfaces/IError.md)[]
+
+The array of errors.
+
+***
+
 ### toJsonObject()
 
 > **toJsonObject**(`includeStackTrace?`): [`IError`](../interfaces/IError.md)

package/docs/reference/classes/ConflictError.md

@@ -10,7 +10,7 @@ Class to handle errors which are triggered by conflicting data.
 
 ### Constructor
 
-> **new ConflictError**(`source`, `message`, `conflictId?`, `conflicts?`, `inner?`): `ConflictError`
+> **new ConflictError**(`source`, `message`, `conflictId?`, `conflicts?`, `cause?`): `ConflictError`
 
 Create a new instance of ConflictError.
 
@@ -40,11 +40,11 @@ The id that has conflicts.
 
 The conflicts that occurred.
 
-##### inner?
+##### cause?
 
 `unknown`
 
-The inner error if we have wrapped another error.
+The cause or the error if we have wrapped another error.
 
 #### Returns
 
@@ -84,15 +84,15 @@ Any additional information for the error.
 
 ***
 
-### inner?
+### cause?
 
-> `optional` **inner**: [`IError`](../interfaces/IError.md)
+> `optional` **cause**: [`IError`](../interfaces/IError.md)
 
-The inner error if there was one.
+The cause of the error.
 
 #### Inherited from
 
-[`BaseError`](BaseError.md).[`inner`](BaseError.md#inner)
+[`BaseError`](BaseError.md).[`cause`](BaseError.md#cause)
 
 ***
 
@@ -410,7 +410,7 @@ True if the error has the name.
 
 > `static` **isEmpty**(`err`): `boolean`
 
-Is the error empty.
+Is the error empty, i.e. does it have no message, source, properties, or cause?
 
 #### Parameters
 
@@ -432,6 +432,64 @@ True if the error is empty.
 
 ***
 
+### isAggregateError()
+
+> `static` **isAggregateError**(`err`): `err is AggregateError`
+
+Is the error an aggregate error.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to check for being an aggregate error.
+
+#### Returns
+
+`err is AggregateError`
+
+True if the error is an aggregate error.
+
+#### Inherited from
+
+[`BaseError`](BaseError.md).[`isAggregateError`](BaseError.md#isaggregateerror)
+
+***
+
+### fromAggregate()
+
+> `static` **fromAggregate**(`err`, `includeStackTrace?`): [`IError`](../interfaces/IError.md)[]
+
+Convert the aggregate error to an array of errors.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The error to convert.
+
+##### includeStackTrace?
+
+`boolean`
+
+Whether to include the error stack in the model, defaults to false.
+
+#### Returns
+
+[`IError`](../interfaces/IError.md)[]
+
+The array of errors.
+
+#### Inherited from
+
+[`BaseError`](BaseError.md).[`fromAggregate`](BaseError.md#fromaggregate)
+
+***
+
 ### toJsonObject()
 
 > **toJsonObject**(`includeStackTrace?`): [`IError`](../interfaces/IError.md)

package/docs/reference/classes/EnvHelper.md

@@ -24,7 +24,7 @@ Get the environment variable as an object with camel cased names.
 
 ##### T
 
-`T` = \{[`id`: `string`]: `string`; \}
+`T` = \{\[`id`: `string`\]: `string`; \}
 
 #### Parameters
 

package/docs/reference/classes/ErrorHelper.md

@@ -38,7 +38,7 @@ Whether to include error details, defaults to false.
 
 `string`[]
 
-The error formatted including any inner errors.
+The error formatted including any causes errors.
 
 ***
 
@@ -46,7 +46,7 @@ The error formatted including any inner errors.
 
 > `static` **localizeErrors**(`error`): [`IError`](../interfaces/IError.md)[]
 
-Localize the content of an error and any inner errors.
+Localize the content of an error and any causes.
 
 #### Parameters
 
@@ -68,7 +68,7 @@ The localized version of the errors flattened.
 
 > `static` **formatValidationErrors**(`error`): `undefined` \| `string`
 
-Localize the content of an error and any inner errors.
+Localize the content of an error and any causes.
 
 #### Parameters
 

package/docs/reference/classes/Factory.md

@@ -186,7 +186,7 @@ GeneralError if no item exists to get.
 
 ### getIfExists()
 
-> **getIfExists**\<`U`\>(`name`): `undefined` \| `U`
+> **getIfExists**\<`U`\>(`name?`): `undefined` \| `U`
 
 Get a generator instance with no exceptions.
 
@@ -198,7 +198,7 @@ Get a generator instance with no exceptions.
 
 #### Parameters
 
-##### name
+##### name?
 
 `string`