@twin.org/core 0.0.1-next.54 → 0.0.1-next.56

package/dist/cjs/index.cjs

@@ -2120,8 +2120,6 @@ class Factory {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const ComponentFactory = Factory.createFactory("component");
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 /**
  * Class to help with arrays.
  */
@@ -2149,6 +2147,20 @@ class ArrayHelper {
         }
         return true;
     }
+    /**
+     * Convert an object or array to an array.
+     * @param value The object or array to convert.
+     * @returns The array.
+     */
+    static fromObjectOrArray(value) {
+        if (Is.empty(value)) {
+            return undefined;
+        }
+        if (Is.array(value)) {
+            return value;
+        }
+        return [value];
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

package/dist/esm/index.mjs

@@ -2118,8 +2118,6 @@ class Factory {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const ComponentFactory = Factory.createFactory("component");
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 /**
  * Class to help with arrays.
  */
@@ -2147,6 +2145,20 @@ class ArrayHelper {
         }
         return true;
     }
+    /**
+     * Convert an object or array to an array.
+     * @param value The object or array to convert.
+     * @returns The array.
+     */
+    static fromObjectOrArray(value) {
+        if (Is.empty(value)) {
+            return undefined;
+        }
+        if (Is.array(value)) {
+            return value;
+        }
+        return [value];
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

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

@@ -1,3 +1,4 @@
+import type { ObjectOrArray } from "../models/objectOrArray";
 /**
  * Class to help with arrays.
  */
@@ -9,4 +10,16 @@ export declare class ArrayHelper {
      * @returns True if both arrays are empty of have the same values.
      */
     static matches(arr1: unknown, arr2: unknown): boolean;
+    /**
+     * Convert an object or array to an array.
+     * @param value The object or array to convert.
+     * @returns The array.
+     */
+    static fromObjectOrArray<T = unknown>(value: undefined): undefined;
+    /**
+     * Convert an object or array to an array.
+     * @param value The object or array to convert.
+     * @returns The array.
+     */
+    static fromObjectOrArray<T = unknown>(value: ObjectOrArray<T>): T[];
 }

package/dist/types/index.d.ts

@@ -38,6 +38,7 @@ export * from "./models/ILocalesIndex";
 export * from "./models/IPatchOperation";
 export * from "./models/IUrlParts";
 export * from "./models/IValidationFailure";
+export * from "./models/objectOrArray";
 export * from "./types/bitString";
 export * from "./types/url";
 export * from "./types/urn";

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

@@ -0,0 +1,4 @@
+/**
+ * Object or array data type
+ */
+export type ObjectOrArray<T = unknown> = T | T[];

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # @twin.org/core - Changelog
 
+## [0.0.1-next.56](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.55...core-v0.0.1-next.56) (2025-05-08)
+
+
+### Features
+
+* add ObjectOrArray and ArrayHelper methods ([0ac9077](https://github.com/twinfoundation/framework/commit/0ac907764d64b38ad1b04b0e9c3027055b527559))
+
+## [0.0.1-next.55](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.54...core-v0.0.1-next.55) (2025-05-07)
+
+
+### Miscellaneous Chores
+
+* **core:** Synchronize repo versions
+
 ## [0.0.1-next.54](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.53...core-v0.0.1-next.54) (2025-05-06)
 
 

package/docs/reference/classes/ArrayHelper.md

@@ -39,3 +39,73 @@ The second array.
 `boolean`
 
 True if both arrays are empty of have the same values.
+
+***
+
+### fromObjectOrArray()
+
+Convert an object or array to an array.
+
+#### Param
+
+The object or array to convert.
+
+#### Call Signature
+
+> `static` **fromObjectOrArray**\<`T`\>(`value`): `undefined`
+
+Convert an object or array to an array.
+
+##### Type Parameters
+
+###### T
+
+`T` = `unknown`
+
+##### Parameters
+
+###### value
+
+`undefined`
+
+The object or array to convert.
+
+##### Returns
+
+`undefined`
+
+The array.
+
+##### Param
+
+The object or array to convert.
+
+#### Call Signature
+
+> `static` **fromObjectOrArray**\<`T`\>(`value`): `T`[]
+
+Convert an object or array to an array.
+
+##### Type Parameters
+
+###### T
+
+`T` = `unknown`
+
+##### Parameters
+
+###### value
+
+[`ObjectOrArray`](../type-aliases/ObjectOrArray.md)\<`T`\>
+
+The object or array to convert.
+
+##### Returns
+
+`T`[]
+
+The array.
+
+##### Param
+
+The object or array to convert.

package/docs/reference/index.md

@@ -59,6 +59,7 @@
 
 - [CoerceType](type-aliases/CoerceType.md)
 - [CompressionType](type-aliases/CompressionType.md)
+- [ObjectOrArray](type-aliases/ObjectOrArray.md)
 
 ## Variables
 

package/docs/reference/type-aliases/ObjectOrArray.md

@@ -0,0 +1,11 @@
+# Type Alias: ObjectOrArray\<T\>
+
+> **ObjectOrArray**\<`T`\> = `T` \| `T`[]
+
+Object or array data type
+
+## Type Parameters
+
+### T
+
+`T` = `unknown`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.1-next.54",
+	"version": "0.0.1-next.56",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",