@twin.org/web 0.0.2-next.12 → 0.0.2-next.14

package/dist/cjs/index.cjs

@@ -723,6 +723,39 @@ class FetchHelper {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Class to helper with header operations.
+ */
+class HeaderHelper {
+    /**
+     * Create a bearer token header.
+     * @param token The token to create the header for.
+     * @returns The bearer token header.
+     */
+    static createBearer(token) {
+        if (core.Is.stringValue(token)) {
+            if (token.startsWith("Bearer ")) {
+                return token;
+            }
+            return `Bearer ${token.trim()}`;
+        }
+        return undefined;
+    }
+    /**
+     * Extract the bearer token from a header.
+     * @param header The header value to extract the token from.
+     * @returns The extracted token if it exists.
+     */
+    static extractBearerToken(header) {
+        if (core.Is.stringValue(header) && header.startsWith("Bearer ")) {
+            return header.slice(7, header.length).trim();
+        }
+        return undefined;
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -1261,6 +1294,7 @@ class MimeTypeHelper {
 
 exports.FetchError = FetchError;
 exports.FetchHelper = FetchHelper;
+exports.HeaderHelper = HeaderHelper;
 exports.HeaderTypes = HeaderTypes;
 exports.HttpMethod = HttpMethod;
 exports.HttpStatusCode = HttpStatusCode;

package/dist/esm/index.mjs

@@ -721,6 +721,39 @@ class FetchHelper {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Class to helper with header operations.
+ */
+class HeaderHelper {
+    /**
+     * Create a bearer token header.
+     * @param token The token to create the header for.
+     * @returns The bearer token header.
+     */
+    static createBearer(token) {
+        if (Is.stringValue(token)) {
+            if (token.startsWith("Bearer ")) {
+                return token;
+            }
+            return `Bearer ${token.trim()}`;
+        }
+        return undefined;
+    }
+    /**
+     * Extract the bearer token from a header.
+     * @param header The header value to extract the token from.
+     * @returns The extracted token if it exists.
+     */
+    static extractBearerToken(header) {
+        if (Is.stringValue(header) && header.startsWith("Bearer ")) {
+            return header.slice(7, header.length).trim();
+        }
+        return undefined;
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -1257,4 +1290,4 @@ class MimeTypeHelper {
     }
 }
 
-export { FetchError, FetchHelper, HeaderTypes, HttpMethod, HttpStatusCode, Jwk, Jws, Jwt, MimeTypeHelper, MimeTypes };
+export { FetchError, FetchHelper, HeaderHelper, HeaderTypes, HttpMethod, HttpStatusCode, Jwk, Jws, Jwt, MimeTypeHelper, MimeTypes };

package/dist/types/index.d.ts

@@ -10,6 +10,7 @@ export * from "./models/IJwtPayload";
 export * from "./models/jwkCryptoKey";
 export * from "./models/mimeTypes";
 export * from "./utils/fetchHelper";
+export * from "./utils/headerHelper";
 export * from "./utils/jwk";
 export * from "./utils/jws";
 export * from "./utils/jwt";

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

@@ -0,0 +1,17 @@
+/**
+ * Class to helper with header operations.
+ */
+export declare class HeaderHelper {
+    /**
+     * Create a bearer token header.
+     * @param token The token to create the header for.
+     * @returns The bearer token header.
+     */
+    static createBearer(token: string): string | undefined;
+    /**
+     * Extract the bearer token from a header.
+     * @param header The header value to extract the token from.
+     * @returns The extracted token if it exists.
+     */
+    static extractBearerToken(header: unknown): string | undefined;
+}

package/docs/changelog.md

@@ -1,5 +1,43 @@
 # @twin.org/web - Changelog
 
+## [0.0.2-next.14](https://github.com/twinfoundation/framework/compare/web-v0.0.2-next.13...web-v0.0.2-next.14) (2025-09-22)
+
+
+### Features
+
+* add header helper for common bearer support ([0c940b2](https://github.com/twinfoundation/framework/commit/0c940b29cccf0c3bb5b4aa8a01f1998010e44d51))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.2-next.13 to 0.0.2-next.14
+    * @twin.org/crypto bumped from 0.0.2-next.13 to 0.0.2-next.14
+    * @twin.org/nameof bumped from 0.0.2-next.13 to 0.0.2-next.14
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.13 to 0.0.2-next.14
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.13 to 0.0.2-next.14
+
+## [0.0.2-next.13](https://github.com/twinfoundation/framework/compare/web-v0.0.2-next.12...web-v0.0.2-next.13) (2025-09-22)
+
+
+### Miscellaneous Chores
+
+* **web:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.2-next.12 to 0.0.2-next.13
+    * @twin.org/crypto bumped from 0.0.2-next.12 to 0.0.2-next.13
+    * @twin.org/nameof bumped from 0.0.2-next.12 to 0.0.2-next.13
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.12 to 0.0.2-next.13
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.12 to 0.0.2-next.13
+
 ## [0.0.2-next.12](https://github.com/twinfoundation/framework/compare/web-v0.0.2-next.11...web-v0.0.2-next.12) (2025-09-15)
 
 

package/docs/reference/classes/HeaderHelper.md

@@ -0,0 +1,57 @@
+# Class: HeaderHelper
+
+Class to helper with header operations.
+
+## Constructors
+
+### Constructor
+
+> **new HeaderHelper**(): `HeaderHelper`
+
+#### Returns
+
+`HeaderHelper`
+
+## Methods
+
+### createBearer()
+
+> `static` **createBearer**(`token`): `undefined` \| `string`
+
+Create a bearer token header.
+
+#### Parameters
+
+##### token
+
+`string`
+
+The token to create the header for.
+
+#### Returns
+
+`undefined` \| `string`
+
+The bearer token header.
+
+***
+
+### extractBearerToken()
+
+> `static` **extractBearerToken**(`header`): `undefined` \| `string`
+
+Extract the bearer token from a header.
+
+#### Parameters
+
+##### header
+
+`unknown`
+
+The header value to extract the token from.
+
+#### Returns
+
+`undefined` \| `string`
+
+The extracted token if it exists.

package/docs/reference/index.md

@@ -4,6 +4,7 @@
 
 - [FetchError](classes/FetchError.md)
 - [FetchHelper](classes/FetchHelper.md)
+- [HeaderHelper](classes/HeaderHelper.md)
 - [Jwk](classes/Jwk.md)
 - [Jws](classes/Jws.md)
 - [Jwt](classes/Jwt.md)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/web",
-	"version": "0.0.2-next.12",
+	"version": "0.0.2-next.14",
 	"description": "Contains classes for use with web operations",
 	"repository": {
 		"type": "git",
@@ -14,9 +14,9 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/core": "0.0.2-next.12",
-		"@twin.org/crypto": "0.0.2-next.12",
-		"@twin.org/nameof": "0.0.2-next.12",
+		"@twin.org/core": "0.0.2-next.14",
+		"@twin.org/crypto": "0.0.2-next.14",
+		"@twin.org/nameof": "0.0.2-next.14",
 		"jose": "6.1.0"
 	},
 	"main": "./dist/cjs/index.cjs",