@twin.org/web 0.0.1-next.5 → 0.0.1-next.50

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

@@ -5,35 +5,35 @@ export declare const HeaderTypes: {
     /**
      * Content Type.
      */
-    readonly ContentType: "Content-Type";
+    readonly ContentType: "content-type";
     /**
      * Content Length.
      */
-    readonly ContentLength: "Content-Length";
+    readonly ContentLength: "content-length";
     /**
      * Content Disposition.
      */
-    readonly ContentDisposition: "Content-Disposition";
+    readonly ContentDisposition: "content-disposition";
     /**
      * Accept.
      */
-    readonly Accept: "Accept";
+    readonly Accept: "accept";
     /**
      * Authorization.
      */
-    readonly Authorization: "Authorization";
+    readonly Authorization: "authorization";
     /**
      * Cookie.
      */
-    readonly Cookie: "Cookie";
+    readonly Cookie: "cookie";
     /**
      * Set Cookie.
      */
-    readonly SetCookie: "Set-Cookie";
+    readonly SetCookie: "set-cookie";
     /**
      * Location
      */
-    readonly Location: "Location";
+    readonly Location: "location";
 };
 /**
  * Common http header types.

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

@@ -0,0 +1,4 @@
+/**
+ * The crypto key for a JWK.
+ */
+export type JwkCryptoKey = CryptoKey | Uint8Array;

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

@@ -22,6 +22,10 @@ export declare const MimeTypes: {
      * JSON-LD - application/ld+json
      */
     readonly JsonLd: "application/ld+json";
+    /**
+     * JWT - application/jwt
+     */
+    readonly Jwt: "application/jwt";
     /**
      * XML - application/xml
      */

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

@@ -44,6 +44,13 @@ export declare class FetchHelper {
      * @returns The cache entry if it exists.
      */
     static getCacheEntry<T>(url: string): Promise<T | undefined>;
+    /**
+     * Set a cache entry.
+     * @param url The url for the request.
+     * @param value The value to cache.
+     * @returns The cache entry if it exists.
+     */
+    static setCacheEntry<T>(url: string, value: T): Promise<void>;
     /**
      * Remove a cache entry.
      * @param url The url for the request.

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

@@ -0,0 +1,34 @@
+import type { IJwk } from "../models/IJwk";
+import type { JwkCryptoKey } from "../models/jwkCryptoKey";
+/**
+ * Class to handle JSON Web Keys.
+ */
+export declare class Jwk {
+    /**
+     * Convert the JWK to a crypto key.
+     * @param jwk The JWK to convert.
+     * @returns The crypto key.
+     */
+    static toCryptoKey(jwk: IJwk): Promise<JwkCryptoKey>;
+    /**
+     * Convert the Ed25519 private key to a crypto key.
+     * @param privateKey The private key to use.
+     * @returns The crypto key.
+     */
+    static fromEd25519Private(privateKey: Uint8Array): Promise<IJwk>;
+    /**
+     * Convert the Ed25519 public key to a crypto key.
+     * @param publicKey The private key to use.
+     * @returns The crypto key.
+     */
+    static fromEd25519Public(publicKey: Uint8Array): Promise<IJwk>;
+    /**
+     * Convert the JWK to raw keys.
+     * @param jwk The JWK to convert to raw.
+     * @returns The crypto key.
+     */
+    static toRaw(jwk: IJwk): Promise<{
+        publicKey?: Uint8Array;
+        privateKey?: Uint8Array;
+    }>;
+}

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

@@ -0,0 +1,22 @@
+import type { JwkCryptoKey } from "../models/jwkCryptoKey";
+/**
+ * Class to handle JSON Web Signatures.
+ */
+export declare class Jws {
+    /**
+     * Create a signature.
+     * @param privateKey The private key to use.
+     * @param hash The hash to sign.
+     * @param algOverride An optional algorithm override.
+     * @returns The signature.
+     */
+    static create(privateKey: JwkCryptoKey, hash: Uint8Array, algOverride?: string): Promise<string>;
+    /**
+     * Verify a signature.
+     * @param jws The signature to verify.
+     * @param publicKey The public key to verify the signature with.
+     * @param hash The hash to verify.
+     * @returns True if the signature was verified.
+     */
+    static verify(jws: string, publicKey: JwkCryptoKey, hash: Uint8Array): Promise<boolean>;
+}

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

@@ -1,8 +1,8 @@
 import type { IJwtHeader } from "../models/IJwtHeader";
 import type { IJwtPayload } from "../models/IJwtPayload";
-import { JwtAlgorithms } from "../models/jwtAlgorithms";
+import type { JwkCryptoKey } from "../models/jwkCryptoKey";
 /**
- * Class to encode and decode JSON Web Tokens.
+ * Class to handle JSON Web Tokens.
  */
 export declare class Jwt {
     /**
@@ -12,7 +12,7 @@ export declare class Jwt {
      * @param key The key for signing the token, can be omitted if a signer is provided.
      * @returns The encoded token.
      */
-    static encode<U extends IJwtHeader, T extends IJwtPayload>(header: U, payload: T, key: Uint8Array): Promise<string>;
+    static encode<T extends IJwtHeader, U extends IJwtPayload>(header: T, payload: U, key: JwkCryptoKey): Promise<string>;
     /**
      * Encode a token.
      * @param header The header to encode.
@@ -20,15 +20,15 @@ export declare class Jwt {
      * @param signer Custom signer method.
      * @returns The encoded token.
      */
-    static encodeWithSigner<U extends IJwtHeader, T extends IJwtPayload>(header: U, payload: T, signer: (alg: JwtAlgorithms, key: Uint8Array | undefined, payload: Uint8Array) => Promise<Uint8Array>): Promise<string>;
+    static encodeWithSigner<T extends IJwtHeader, U extends IJwtPayload>(header: T, payload: U, signer: (header: IJwtHeader, payload: IJwtPayload, key: JwkCryptoKey | undefined) => Promise<string>): Promise<string>;
     /**
      * Decode a token.
      * @param token The token to decode.
      * @returns The decoded payload.
      */
-    static decode<U extends IJwtHeader, T extends IJwtPayload>(token: string): Promise<{
-        header?: U;
-        payload?: T;
+    static decode<T extends IJwtHeader, U extends IJwtPayload>(token: string): Promise<{
+        header?: T;
+        payload?: U;
         signature?: Uint8Array;
     }>;
     /**
@@ -37,11 +37,9 @@ export declare class Jwt {
      * @param key The key for verifying the token
      * @returns The decoded payload.
      */
-    static verify<U extends IJwtHeader, T extends IJwtPayload>(token: string, key: Uint8Array): Promise<{
-        verified: boolean;
-        header?: U;
-        payload?: T;
-        signature?: Uint8Array;
+    static verify<T extends IJwtHeader, U extends IJwtPayload>(token: string, key: JwkCryptoKey): Promise<{
+        header: T;
+        payload: U;
     }>;
     /**
      * Verify a token.
@@ -49,37 +47,77 @@ export declare class Jwt {
      * @param verifier Custom verification method.
      * @returns The decoded payload.
      */
-    static verifyWithVerifier<U extends IJwtHeader, T extends IJwtPayload>(token: string, verifier: (alg: JwtAlgorithms, key: Uint8Array | undefined, payload: Uint8Array, signature: Uint8Array) => Promise<boolean>): Promise<{
-        verified: boolean;
-        header?: U;
-        payload?: T;
-        signature?: Uint8Array;
+    static verifyWithVerifier<T extends IJwtHeader, U extends IJwtPayload>(token: string, verifier: (token: string, key: JwkCryptoKey | undefined) => Promise<{
+        header: T;
+        payload: U;
+    }>): Promise<{
+        header: T;
+        payload: U;
     }>;
     /**
      * Verify a token by parts.
-     * @param header The header to verify.
-     * @param payload The payload to verify.
-     * @param signature The signature to verify.
+     * @param token The token to verify.
      * @param key The key for verifying the token, if not provided no verification occurs.
      * @param verifier Custom verification method.
      * @returns True if the parts are verified.
      */
-    static verifySignature<U extends IJwtHeader, T extends IJwtPayload>(header?: U, payload?: T, signature?: Uint8Array, key?: Uint8Array, verifier?: (alg: JwtAlgorithms, key: Uint8Array | undefined, payload: Uint8Array, signature: Uint8Array) => Promise<boolean>): Promise<boolean>;
+    static verifySignature<T extends IJwtHeader, U extends IJwtPayload>(token: string, key?: JwkCryptoKey, verifier?: (token: string, key: JwkCryptoKey | undefined) => Promise<{
+        header: T;
+        payload: U;
+    }>): Promise<{
+        header: T;
+        payload: U;
+    }>;
     /**
      * The default signer for the JWT.
-     * @param alg The algorithm to use.
-     * @param key The key to sign with.
+     * @param header The header to sign.
      * @param payload The payload to sign.
+     * @param key The optional key to sign with.
      * @returns The signature.
      */
-    static defaultSigner(alg: JwtAlgorithms, key: Uint8Array | undefined, payload: Uint8Array): Promise<Uint8Array>;
+    static defaultSigner(header: IJwtHeader, payload: IJwtPayload, key: JwkCryptoKey | undefined): Promise<string>;
     /**
      * The default verifier for the JWT.
-     * @param alg The algorithm to use.
+     * @param token The token to verify.
      * @param key The key to verify with.
-     * @param payload The payload to verify.
-     * @param signature The signature to verify.
-     * @returns True if the signature was verified.
+     * @returns The header and payload if verification successful.
+     */
+    static defaultVerifier<T extends IJwtHeader, U extends IJwtPayload>(token: string, key: JwkCryptoKey | undefined): Promise<{
+        header: T;
+        payload: U;
+    }>;
+    /**
+     * Create bytes for signing from header and payload.
+     * @param header The header.
+     * @param payload The payload.
+     * @returns The bytes to sign.
+     */
+    static toSigningBytes<T extends IJwtHeader, U extends IJwtPayload>(header: T, payload: U): Uint8Array;
+    /**
+     * Create header and payload from signing bytes.
+     * @param signingBytes The signing bytes from a token.
+     * @returns The header and payload.
+     * @throws If the signing bytes are invalid
+     */
+    static fromSigningBytes<T extends IJwtHeader, U extends IJwtPayload>(signingBytes: Uint8Array): {
+        header: T;
+        payload: U;
+    };
+    /**
+     * Convert signed bytes and signature bytes to token.
+     * @param signingBytes The signed bytes.
+     * @param signature The signature.
+     * @returns The token.
+     */
+    static tokenFromBytes(signingBytes: Uint8Array, signature: Uint8Array): string;
+    /**
+     * Convert the token to signing bytes and signature bytes.
+     * @param token The token to convert to bytes.
+     * @returns The decoded bytes.
+     * @throws If the token is invalid.
      */
-    static defaultVerifier(alg: JwtAlgorithms, key: Uint8Array | undefined, payload: Uint8Array, signature: Uint8Array): Promise<boolean>;
+    static tokenToBytes(token: string): {
+        signingBytes: Uint8Array;
+        signature: Uint8Array;
+    };
 }

package/docs/changelog.md

@@ -1,5 +1,20 @@
 # @twin.org/web - Changelog
 
-## 0.0.1-next.5
+## [0.0.1-next.50](https://github.com/twinfoundation/framework/compare/web-v0.0.1-next.49...web-v0.0.1-next.50) (2025-03-26)
+
+
+### Features
+
+* add set method for async caches ([ba34b55](https://github.com/twinfoundation/framework/commit/ba34b55e651ad56ab8fc59e139e4af631c19cda0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.1-next.49 to 0.0.1-next.50
+    * @twin.org/crypto bumped from 0.0.1-next.49 to 0.0.1-next.50
+
+## 0.0.1-next.49
 
 - Initial Release

package/docs/reference/classes/FetchError.md

@@ -16,23 +16,31 @@ Create a new instance of FetchError.
 
 #### Parameters
 
-• **source**: `string`
+##### source
+
+`string`
 
 The source of the error.
 
-• **message**: `string`
+##### message
+
+`string`
 
 The message as a code.
 
-• **httpStatus**: [`HttpStatusCode`](../type-aliases/HttpStatusCode.md)
+##### httpStatus
+
+[`HttpStatusCode`](../type-aliases/HttpStatusCode.md)
 
 The http status code.
 
-• **properties?**
+##### properties?
 
 Any additional information for the error.
 
-• **inner?**: `unknown`
+##### inner?
+
+`unknown`
 
 The inner error if we have wrapped another error.
 

package/docs/reference/classes/FetchHelper.md

@@ -22,23 +22,33 @@ Perform a fetch request.
 
 #### Parameters
 
-• **source**: `string`
+##### source
+
+`string`
 
 The source for the request.
 
-• **url**: `string`
+##### url
+
+`string`
 
 The url for the request.
 
-• **method**: [`HttpMethod`](../type-aliases/HttpMethod.md)
+##### method
+
+[`HttpMethod`](../type-aliases/HttpMethod.md)
 
 The http method.
 
-• **body?**: `string` \| `Uint8Array`
+##### body?
 
 Request to send to the endpoint.
 
-• **options?**: `Omit`\<[`IFetchOptions`](../interfaces/IFetchOptions.md), `"cacheTtlSeconds"`\>
+`string` | `Uint8Array`\<`ArrayBufferLike`\>
+
+##### options?
+
+`Omit`\<[`IFetchOptions`](../interfaces/IFetchOptions.md), `"cacheTtlSeconds"`\>
 
 Options for sending the requests.
 
@@ -64,23 +74,33 @@ Perform a request in json format.
 
 #### Parameters
 
-• **source**: `string`
+##### source
+
+`string`
 
 The source for the request.
 
-• **url**: `string`
+##### url
+
+`string`
 
 The url for the request.
 
-• **method**: [`HttpMethod`](../type-aliases/HttpMethod.md)
+##### method
+
+[`HttpMethod`](../type-aliases/HttpMethod.md)
 
 The http method.
 
-• **requestData?**: `T`
+##### requestData?
+
+`T`
 
 Request to send to the endpoint.
 
-• **options?**: [`IFetchOptions`](../interfaces/IFetchOptions.md)
+##### options?
+
+[`IFetchOptions`](../interfaces/IFetchOptions.md)
 
 Options for sending the requests.
 
@@ -94,7 +114,7 @@ The response.
 
 ### fetchBinary()
 
-> `static` **fetchBinary**\<`T`\>(`source`, `url`, `method`, `requestData`?, `options`?): `Promise`\<`Uint8Array` \| `T`\>
+> `static` **fetchBinary**\<`T`\>(`source`, `url`, `method`, `requestData`?, `options`?): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `T`\>
 
 Perform a request for binary data.
 
@@ -104,29 +124,39 @@ Perform a request for binary data.
 
 #### Parameters
 
-• **source**: `string`
+##### source
+
+`string`
 
 The source for the request.
 
-• **url**: `string`
+##### url
+
+`string`
 
 The url for the request.
 
-• **method**: `"GET"` \| `"POST"`
+##### method
 
 The http method.
 
-• **requestData?**: `Uint8Array`
+`"GET"` | `"POST"`
+
+##### requestData?
+
+`Uint8Array`\<`ArrayBufferLike`\>
 
 Request to send to the endpoint.
 
-• **options?**: [`IFetchOptions`](../interfaces/IFetchOptions.md)
+##### options?
+
+[`IFetchOptions`](../interfaces/IFetchOptions.md)
 
 Options for sending the requests.
 
 #### Returns
 
-`Promise`\<`Uint8Array` \| `T`\>
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `T`\>
 
 The response.
 
@@ -156,7 +186,9 @@ Get a cache entry.
 
 #### Parameters
 
-• **url**: `string`
+##### url
+
+`string`
 
 The url for the request.
 
@@ -168,6 +200,38 @@ The cache entry if it exists.
 
 ***
 
+### setCacheEntry()
+
+> `static` **setCacheEntry**\<`T`\>(`url`, `value`): `Promise`\<`void`\>
+
+Set a cache entry.
+
+#### Type Parameters
+
+• **T**
+
+#### Parameters
+
+##### url
+
+`string`
+
+The url for the request.
+
+##### value
+
+`T`
+
+The value to cache.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+The cache entry if it exists.
+
+***
+
 ### removeCacheEntry()
 
 > `static` **removeCacheEntry**(`url`): `void`
@@ -176,7 +240,9 @@ Remove a cache entry.
 
 #### Parameters
 
-• **url**: `string`
+##### url
+
+`string`
 
 The url for the request.
 

package/docs/reference/classes/Jwk.md

@@ -0,0 +1,101 @@
+# Class: Jwk
+
+Class to handle JSON Web Keys.
+
+## Constructors
+
+### new Jwk()
+
+> **new Jwk**(): [`Jwk`](Jwk.md)
+
+#### Returns
+
+[`Jwk`](Jwk.md)
+
+## Methods
+
+### toCryptoKey()
+
+> `static` **toCryptoKey**(`jwk`): `Promise`\<[`JwkCryptoKey`](../type-aliases/JwkCryptoKey.md)\>
+
+Convert the JWK to a crypto key.
+
+#### Parameters
+
+##### jwk
+
+[`IJwk`](../interfaces/IJwk.md)
+
+The JWK to convert.
+
+#### Returns
+
+`Promise`\<[`JwkCryptoKey`](../type-aliases/JwkCryptoKey.md)\>
+
+The crypto key.
+
+***
+
+### fromEd25519Private()
+
+> `static` **fromEd25519Private**(`privateKey`): `Promise`\<[`IJwk`](../interfaces/IJwk.md)\>
+
+Convert the Ed25519 private key to a crypto key.
+
+#### Parameters
+
+##### privateKey
+
+`Uint8Array`
+
+The private key to use.
+
+#### Returns
+
+`Promise`\<[`IJwk`](../interfaces/IJwk.md)\>
+
+The crypto key.
+
+***
+
+### fromEd25519Public()
+
+> `static` **fromEd25519Public**(`publicKey`): `Promise`\<[`IJwk`](../interfaces/IJwk.md)\>
+
+Convert the Ed25519 public key to a crypto key.
+
+#### Parameters
+
+##### publicKey
+
+`Uint8Array`
+
+The private key to use.
+
+#### Returns
+
+`Promise`\<[`IJwk`](../interfaces/IJwk.md)\>
+
+The crypto key.
+
+***
+
+### toRaw()
+
+> `static` **toRaw**(`jwk`): `Promise`\<\{ `publicKey`: `Uint8Array`\<`ArrayBufferLike`\>; `privateKey`: `Uint8Array`\<`ArrayBufferLike`\>; \}\>
+
+Convert the JWK to raw keys.
+
+#### Parameters
+
+##### jwk
+
+[`IJwk`](../interfaces/IJwk.md)
+
+The JWK to convert to raw.
+
+#### Returns
+
+`Promise`\<\{ `publicKey`: `Uint8Array`\<`ArrayBufferLike`\>; `privateKey`: `Uint8Array`\<`ArrayBufferLike`\>; \}\>
+
+The crypto key.