@twin.org/web 0.0.3-next.21 → 0.0.3-next.23

package/README.md

@@ -1,6 +1,6 @@
 # TWIN Web
 
-Contains classes for use with web operations.
+This package is part of the framework workspace and provides classes for use with web operations to support consistent development workflows across the ecosystem.
 
 ## Installation
 

package/docs/changelog.md

@@ -1,4 +1,44 @@
-# @twin.org/web - Changelog
+# Changelog
+
+## [0.0.3-next.23](https://github.com/twinfoundation/framework/compare/web-v0.0.3-next.22...web-v0.0.3-next.23) (2026-03-17)
+
+
+### Miscellaneous Chores
+
+* **web:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/crypto bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/nameof bumped from 0.0.3-next.22 to 0.0.3-next.23
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.22 to 0.0.3-next.23
+    * @twin.org/validate-locales bumped from 0.0.3-next.22 to 0.0.3-next.23
+
+## [0.0.3-next.22](https://github.com/twinfoundation/framework/compare/web-v0.0.3-next.21...web-v0.0.3-next.22) (2026-02-26)
+
+
+### Miscellaneous Chores
+
+* **web:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/core bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/crypto bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/nameof bumped from 0.0.3-next.21 to 0.0.3-next.22
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.3-next.21 to 0.0.3-next.22
+    * @twin.org/validate-locales bumped from 0.0.3-next.21 to 0.0.3-next.22
 
 ## [0.0.3-next.21](https://github.com/twinfoundation/framework/compare/web-v0.0.3-next.20...web-v0.0.3-next.21) (2026-02-26)
 

package/docs/examples.md

@@ -1 +1,108 @@
-# @twin.org/web - Examples
+# Web Examples
+
+Use these snippets for token handling, fetch utilities and HTTP header helpers in browser and server runtimes.
+
+## Jwt
+
+```typescript
+import { Jwt } from '@twin.org/web';
+
+const payload = {
+  sub: 'user-01',
+  role: 'editor'
+};
+
+const token = Jwt.encode(payload, {
+  alg: 'HS256'
+});
+
+Jwt.decode(token).sub; // 'user-01'
+```
+
+```typescript
+import { Jwt } from '@twin.org/web';
+
+const token = Jwt.encode({ sub: 'u-2' }, { alg: 'HS256' });
+Jwt.verify(token, {
+  key: 'local-signing-key'
+}); // true
+```
+
+## FetchHelper
+
+```typescript
+import { FetchHelper } from '@twin.org/web';
+
+const response = await FetchHelper.fetchJson<{ status: string }>('https://api.example.org/status', {
+  method: 'GET',
+  cacheSeconds: 30
+});
+
+response.status; // 'ok'
+```
+
+## HeaderHelper
+
+```typescript
+import { HeaderHelper } from '@twin.org/web';
+
+const header = HeaderHelper.createBearer('token-123');
+
+HeaderHelper.extractBearer(header); // 'token-123'
+```
+
+## Jwk and Jws
+
+```typescript
+import { Jwk, Jws } from '@twin.org/web';
+
+const jwk = Jwk.fromEd25519Public(new Uint8Array(32));
+const compact = Jws.create(
+  {
+    typ: 'JWT',
+    alg: 'EdDSA'
+  },
+  {
+    iss: 'issuer-1'
+  },
+  async signingBytes => signingBytes
+);
+
+Jws.verify(compact, async () => true); // true
+jwk.kty; // 'OKP'
+```
+
+## CookieHelper
+
+```typescript
+import { CookieHelper } from '@twin.org/web';
+
+CookieHelper.createCookie('sessionId', 'abc123', {
+  path: '/',
+  maxAge: 1800,
+  secure: true,
+  httpOnly: true
+}); // 'sessionId=abc123; Max-Age=1800; Path=/; Secure; HttpOnly'
+```
+
+## MimeTypeHelper
+
+```typescript
+import { MimeTypeHelper } from '@twin.org/web';
+
+MimeTypeHelper.detect('avatar.png'); // 'image/png'
+MimeTypeHelper.defaultExtension('application/json'); // 'json'
+```
+
+## FetchError
+
+```typescript
+import { FetchError } from '@twin.org/web';
+
+const error = new FetchError(this.CLASS_NAME, 'fetchFailed', {
+  statusCode: 503,
+  retryable: true
+});
+
+error.toJsonObject().statusCode; // 503
+```

package/docs/reference/classes/CookieHelper.md

@@ -14,7 +14,7 @@ Class to help with cookie operations.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -22,7 +22,7 @@ Runtime name for the class.
 
 ## Methods
 
-### createCookie()
+### createCookie() {#createcookie}
 
 > `static` **createCookie**(`cookieName`, `cookieValue`, `options?`): `string`
 
@@ -78,7 +78,7 @@ The created cookie string.
 
 ***
 
-### deleteCookie()
+### deleteCookie() {#deletecookie}
 
 > `static` **deleteCookie**(`cookieName`, `options?`): `string`
 
@@ -128,7 +128,7 @@ The created cookie string.
 
 ***
 
-### getCookieFromHeaders()
+### getCookieFromHeaders() {#getcookiefromheaders}
 
 > `static` **getCookieFromHeaders**(`headers`, `cookieName`): `string` \| `undefined`
 

package/docs/reference/classes/FetchError.md

@@ -54,8 +54,460 @@ The cause of the error if we have wrapped another error.
 
 ## Properties
 
-### CLASS\_NAME
+### source? {#source}
+
+> `optional` **source**: `string`
+
+The source of the error.
+
+#### Inherited from
+
+`BaseError.source`
+
+***
+
+### properties? {#properties}
+
+> `optional` **properties**: `object`
+
+Any additional information for the error.
+
+#### Index Signature
+
+\[`id`: `string`\]: `unknown`
+
+#### Inherited from
+
+`BaseError.properties`
+
+***
+
+### cause? {#cause}
+
+> `optional` **cause**: `IError`
+
+The cause of the error.
+
+#### Inherited from
+
+`BaseError.cause`
+
+***
+
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
 Runtime name for the class.
+
+## Methods
+
+### fromError() {#fromerror}
+
+> `static` **fromError**(`err`): `BaseError`
+
+Construct an error from an existing one.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The existing error.
+
+#### Returns
+
+`BaseError`
+
+The new instance.
+
+#### Inherited from
+
+`BaseError.fromError`
+
+***
+
+### flatten() {#flatten}
+
+> `static` **flatten**(`err`): `IError`[]
+
+Flatten an error tree.
+
+#### Parameters
+
+##### err
+
+`unknown`
+
+The starting error.
+
+#### Returns
+
+`IError`[]
+
+The list of all internal errors.
+
+#### Inherited from
+
+`BaseError.flatten`
+
+***
+
+### expand() {#expand}
+
+> `static` **expand**(`errors`): `IError` \| `undefined`
+
+Expand an error tree.
+
+#### Parameters
+
+##### errors
+
+The list of errors to expand.
+
+`IError`[] | `undefined`
+
+#### Returns
+
+`IError` \| `undefined`
+
+The first level error.
+
+#### Inherited from
+
+`BaseError.expand`
+
+***
+
+### isErrorName() {#iserrorname}
+
+> `static` **isErrorName**(`error`, `name`): `error is BaseError`
+
+Test to see if the error has the specified error name.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### name
+
+The name to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the name.
+
+#### Inherited from
+
+`BaseError.isErrorName`
+
+***
+
+### isErrorMessage() {#iserrormessage}
+
+> `static` **isErrorMessage**(`error`, `message`): `error is BaseError`
+
+Test to see if the error has the specified error message.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### message
+
+The message to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the name.
+
+#### Inherited from
+
+`BaseError.isErrorMessage`
+
+***
+
+### isErrorCode() {#iserrorcode}
+
+> `static` **isErrorCode**(`error`, `code`): `boolean`
+
+Test to see if the error has the specified error code.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### code
+
+The code to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`boolean`
+
+True if the error has the code.
+
+#### Inherited from
+
+`BaseError.isErrorCode`
+
+***
+
+### someErrorName() {#someerrorname}
+
+> `static` **someErrorName**(`error`, `name`): `error is BaseError`
+
+Test to see if any of the errors or children have the given error name.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### name
+
+The name to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the name.
+
+#### Inherited from
+
+`BaseError.someErrorName`
+
+***
+
+### someErrorMessage() {#someerrormessage}
+
+> `static` **someErrorMessage**(`error`, `message`): `error is BaseError`
+
+Test to see if any of the errors or children have the given error message.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### message
+
+The message to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the name.
+
+#### Inherited from
+
+`BaseError.someErrorMessage`
+
+***
+
+### someErrorClass() {#someerrorclass}
+
+> `static` **someErrorClass**(`error`, `cls`): `error is BaseError`
+
+Test to see if any of the errors or children are from a specific class.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### cls
+
+`string`
+
+The class to check for.
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the specific class.
+
+#### Inherited from
+
+`BaseError.someErrorClass`
+
+***
+
+### someErrorCode() {#someerrorcode}
+
+> `static` **someErrorCode**(`error`, `code`): `error is BaseError`
+
+Test to see if any of the errors or children have the given error code.
+
+#### Parameters
+
+##### error
+
+`unknown`
+
+The error to test.
+
+##### code
+
+The code to check for.
+
+`string` | `RegExp`
+
+#### Returns
+
+`error is BaseError`
+
+True if the error has the name.
+
+#### Inherited from
+
+`BaseError.someErrorCode`
+
+***
+
+### isEmpty() {#isempty}
+
+> `static` **isEmpty**(`err`): `boolean`
+
+Is the error empty, i.e. does it have no message, source, properties, or cause?
+
+#### Parameters
+
+##### err
+
+`IError`
+
+The error to check for being empty.
+
+#### Returns
+
+`boolean`
+
+True if the error is empty.
+
+#### Inherited from
+
+`BaseError.isEmpty`
+
+***
+
+### isAggregateError() {#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.isAggregateError`
+
+***
+
+### fromAggregate() {#fromaggregate}
+
+> `static` **fromAggregate**(`err`, `includeStackTrace?`): `IError`[]
+
+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`[]
+
+The array of errors.
+
+#### Inherited from
+
+`BaseError.fromAggregate`
+
+***
+
+### toJsonObject() {#tojsonobject}
+
+> **toJsonObject**(`includeStackTrace?`): `IError`
+
+Serialize the error to the error model.
+
+#### Parameters
+
+##### includeStackTrace?
+
+`boolean`
+
+Whether to include the error stack in the model, defaults to false.
+
+#### Returns
+
+`IError`
+
+The error model.
+
+#### Inherited from
+
+`BaseError.toJsonObject`

package/docs/reference/classes/FetchHelper.md

@@ -14,7 +14,7 @@ Class to helper with fetch operations.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -22,7 +22,7 @@ Runtime name for the class.
 
 ## Methods
 
-### fetch()
+### fetch() {#fetch}
 
 > `static` **fetch**(`source`, `url`, `method`, `body?`, `options?`): `Promise`\<`Response`\>
 
@@ -68,7 +68,7 @@ The response.
 
 ***
 
-### fetchJson()
+### fetchJson() {#fetchjson}
 
 > `static` **fetchJson**\<`T`, `U`\>(`source`, `url`, `method`, `requestData?`, `options?`): `Promise`\<`U`\>
 
@@ -124,7 +124,7 @@ The response.
 
 ***
 
-### fetchBinary()
+### fetchBinary() {#fetchbinary}
 
 > `static` **fetchBinary**\<`T`\>(`source`, `url`, `method`, `requestData?`, `options?`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `T`\>
 
@@ -176,7 +176,7 @@ The response.
 
 ***
 
-### clearCache()
+### clearCache() {#clearcache}
 
 > `static` **clearCache**(): `void`
 
@@ -188,7 +188,7 @@ Clears the cache.
 
 ***
 
-### getCacheEntry()
+### getCacheEntry() {#getcacheentry}
 
 > `static` **getCacheEntry**\<`T`\>(`url`): `Promise`\<`T` \| `undefined`\>
 
@@ -216,7 +216,7 @@ The cache entry if it exists.
 
 ***
 
-### setCacheEntry()
+### setCacheEntry() {#setcacheentry}
 
 > `static` **setCacheEntry**\<`T`\>(`url`, `value`): `Promise`\<`void`\>
 
@@ -250,7 +250,7 @@ The cache entry if it exists.
 
 ***
 
-### removeCacheEntry()
+### removeCacheEntry() {#removecacheentry}
 
 > `static` **removeCacheEntry**(`url`): `void`