@twin.org/core 0.0.2-next.15 → 0.0.2-next.17

package/dist/cjs/index.cjs

@@ -398,26 +398,26 @@ class Is {
  */
 class StringHelper {
     /**
-     * Trim trailing slashes from a string.
+     * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimTrailingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/\/+$/, "");
         }
-        return "";
+        return value;
     }
     /**
-     * Trim leading slashes from a string.
+     * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimLeadingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/^\/+/, "");
         }
-        return "";
+        return value;
     }
     /**
      * Convert the input string to kebab case.
@@ -2705,7 +2705,7 @@ class ObjectHelper {
      * @returns The object as bytes.
      */
     static toBytes(obj, format = false) {
-        if (obj === undefined) {
+        if (Is.undefined(obj)) {
             return new Uint8Array();
         }
         const json = format ? JSON.stringify(obj, undefined, "\t") : JSON.stringify(obj);

package/dist/esm/index.mjs

@@ -396,26 +396,26 @@ class Is {
  */
 class StringHelper {
     /**
-     * Trim trailing slashes from a string.
+     * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimTrailingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/\/+$/, "");
         }
-        return "";
+        return value;
     }
     /**
-     * Trim leading slashes from a string.
+     * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimLeadingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/^\/+/, "");
         }
-        return "";
+        return value;
     }
     /**
      * Convert the input string to kebab case.
@@ -2703,7 +2703,7 @@ class ObjectHelper {
      * @returns The object as bytes.
      */
     static toBytes(obj, format = false) {
-        if (obj === undefined) {
+        if (Is.undefined(obj)) {
             return new Uint8Array();
         }
         const json = format ? JSON.stringify(obj, undefined, "\t") : JSON.stringify(obj);

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

@@ -4,16 +4,28 @@
 export declare class StringHelper {
     /**
      * Trim trailing slashes from a string.
+     * Overloads preserve null/undefined instead of coercing to empty string.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed value (same null/undefined passed in).
      */
-    static trimTrailingSlashes(value: string | undefined): string;
+    static trimTrailingSlashes(value: string): string;
+    /**
+     *
+     * @param value
+     */
+    static trimTrailingSlashes<T extends null | undefined>(value: T): T;
     /**
      * Trim leading slashes from a string.
+     * Overloads preserve null/undefined instead of coercing to empty string.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed value (same null/undefined passed in).
+     */
+    static trimLeadingSlashes(value: string): string;
+    /**
+     * Overload for null/undefined passthrough.
+     * @param value The null or undefined value.
      */
-    static trimLeadingSlashes(value: string | undefined): string;
+    static trimLeadingSlashes<T extends null | undefined>(value: T): T;
     /**
      * Convert the input string to kebab case.
      * @param input The input to convert.

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

@@ -11,19 +11,19 @@ export interface IComponent {
      * @param nodeLoggingComponentType The node logging component type.
      * @returns True if the bootstrapping process was successful.
      */
-    bootstrap?(nodeLoggingComponentType: string | undefined): Promise<boolean>;
+    bootstrap?(nodeLoggingComponentType?: string): Promise<boolean>;
     /**
      * The component needs to be started when the node is initialized.
      * @param nodeIdentity The identity of the node starting the component.
      * @param nodeLoggingComponentType The node logging component type.
      * @returns Nothing.
      */
-    start?(nodeIdentity: string, nodeLoggingComponentType: string | undefined): Promise<void>;
+    start?(nodeIdentity?: string, nodeLoggingComponentType?: string): Promise<void>;
     /**
      * The component needs to be stopped when the node is closed.
      * @param nodeIdentity The identity of the node stopping the component.
      * @param nodeLoggingComponentType The node logging component type.
      * @returns Nothing.
      */
-    stop?(nodeIdentity: string, nodeLoggingComponentType: string | undefined): Promise<void>;
+    stop?(nodeIdentity?: string, nodeLoggingComponentType?: string): Promise<void>;
 }

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

@@ -195,7 +195,7 @@ export declare class Is {
      * @param value The value to test.
      * @returns True if the value is a function.
      */
-    static function(value: unknown): value is (...args: unknown[]) => unknown;
+    static function<FN extends (args?: unknown[]) => unknown = (args?: unknown[]) => unknown>(value: unknown): value is FN;
     /**
      * Is the value a string formatted as an email address.
      * @param value The value to test.

package/docs/changelog.md

@@ -1,5 +1,40 @@
 # @twin.org/core - Changelog
 
+## [0.0.2-next.17](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.16...core-v0.0.2-next.17) (2025-09-29)
+
+
+### Features
+
+* additional nameof operators ([a5aab60](https://github.com/twinfoundation/framework/commit/a5aab60bf66a86f1b7ff8af7c4f044cb03706d50))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.16 to 0.0.2-next.17
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.16 to 0.0.2-next.17
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.16 to 0.0.2-next.17
+
+## [0.0.2-next.16](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.15...core-v0.0.2-next.16) (2025-09-28)
+
+
+### Features
+
+* improve Is.function definition to retain types ([f20b6b0](https://github.com/twinfoundation/framework/commit/f20b6b0dd16e74b75dc359be72b05989305c6410))
+* nodeIdentity optional in IComponent methods ([c78dc17](https://github.com/twinfoundation/framework/commit/c78dc17f4357d3e1ae40e415f468d3eae13e81f4))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.15 to 0.0.2-next.16
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.15 to 0.0.2-next.16
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.15 to 0.0.2-next.16
+
 ## [0.0.2-next.15](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.14...core-v0.0.2-next.15) (2025-09-22)
 
 

package/docs/reference/classes/Is.md

@@ -730,10 +730,16 @@ True if the value is a TypedArray.
 
 ### function()
 
-> `static` **function**(`value`): `value is (args: unknown[]) => unknown`
+> `static` **function**\<`FN`\>(`value`): `value is FN`
 
 Is the property a function.
 
+#### Type Parameters
+
+##### FN
+
+`FN` *extends* (`args?`) => `unknown` = (`args?`) => `unknown`
+
 #### Parameters
 
 ##### value
@@ -744,7 +750,7 @@ The value to test.
 
 #### Returns
 
-`value is (args: unknown[]) => unknown`
+`value is FN`
 
 True if the value is a function.
 

package/docs/reference/classes/StringHelper.md

@@ -16,45 +16,107 @@ Class to help with string.
 
 ### trimTrailingSlashes()
 
+Implementation signature for trimTrailingSlashes.
+
+#### Param
+
+The value to trim.
+
+#### Call Signature
+
 > `static` **trimTrailingSlashes**(`value`): `string`
 
 Trim trailing slashes from a string.
+Overloads preserve null/undefined instead of coercing to empty string.
 
-#### Parameters
+##### Parameters
 
-##### value
+###### value
+
+`string`
 
 The value to trim.
 
-`undefined` | `string`
-
-#### Returns
+##### Returns
 
 `string`
 
-The trimmed value.
+The trimmed value (same null/undefined passed in).
+
+#### Call Signature
+
+> `static` **trimTrailingSlashes**\<`T`\>(`value`): `T`
+
+##### Type Parameters
+
+###### T
+
+`T` *extends* `undefined` \| `null`
+
+##### Parameters
+
+###### value
+
+`T`
+
+##### Returns
+
+`T`
 
 ***
 
 ### trimLeadingSlashes()
 
+Implementation signature for trimLeadingSlashes.
+
+#### Param
+
+The value to trim.
+
+#### Call Signature
+
 > `static` **trimLeadingSlashes**(`value`): `string`
 
 Trim leading slashes from a string.
+Overloads preserve null/undefined instead of coercing to empty string.
 
-#### Parameters
+##### Parameters
 
-##### value
+###### value
 
-The value to trim.
+`string`
 
-`undefined` | `string`
+The value to trim.
 
-#### Returns
+##### Returns
 
 `string`
 
-The trimmed value.
+The trimmed value (same null/undefined passed in).
+
+#### Call Signature
+
+> `static` **trimLeadingSlashes**\<`T`\>(`value`): `T`
+
+Overload for null/undefined passthrough.
+
+##### Type Parameters
+
+###### T
+
+`T` *extends* `undefined` \| `null`
+
+##### Parameters
+
+###### value
+
+`T`
+
+The null or undefined value.
+
+##### Returns
+
+`T`
 
 ***
 

package/docs/reference/interfaces/IComponent.md

@@ -14,17 +14,17 @@ The name of the component.
 
 ### bootstrap()?
 
-> `optional` **bootstrap**(`nodeLoggingComponentType`): `Promise`\<`boolean`\>
+> `optional` **bootstrap**(`nodeLoggingComponentType?`): `Promise`\<`boolean`\>
 
 Bootstrap the component by creating and initializing any resources it needs.
 
 #### Parameters
 
-##### nodeLoggingComponentType
+##### nodeLoggingComponentType?
 
-The node logging component type.
+`string`
 
-`undefined` | `string`
+The node logging component type.
 
 #### Returns
 
@@ -36,23 +36,23 @@ True if the bootstrapping process was successful.
 
 ### start()?
 
-> `optional` **start**(`nodeIdentity`, `nodeLoggingComponentType`): `Promise`\<`void`\>
+> `optional` **start**(`nodeIdentity?`, `nodeLoggingComponentType?`): `Promise`\<`void`\>
 
 The component needs to be started when the node is initialized.
 
 #### Parameters
 
-##### nodeIdentity
+##### nodeIdentity?
 
 `string`
 
 The identity of the node starting the component.
 
-##### nodeLoggingComponentType
+##### nodeLoggingComponentType?
 
-The node logging component type.
+`string`
 
-`undefined` | `string`
+The node logging component type.
 
 #### Returns
 
@@ -64,23 +64,23 @@ Nothing.
 
 ### stop()?
 
-> `optional` **stop**(`nodeIdentity`, `nodeLoggingComponentType`): `Promise`\<`void`\>
+> `optional` **stop**(`nodeIdentity?`, `nodeLoggingComponentType?`): `Promise`\<`void`\>
 
 The component needs to be stopped when the node is closed.
 
 #### Parameters
 
-##### nodeIdentity
+##### nodeIdentity?
 
 `string`
 
 The identity of the node stopping the component.
 
-##### nodeLoggingComponentType
+##### nodeLoggingComponentType?
 
-The node logging component type.
+`string`
 
-`undefined` | `string`
+The node logging component type.
 
 #### Returns
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.2-next.15",
+	"version": "0.0.2-next.17",
 	"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.0.2-next.15",
+		"@twin.org/nameof": "0.0.2-next.17",
 		"intl-messageformat": "10.7.16",
 		"rfc6902": "5.1.2"
 	},