feat: additional documentation

AGENTS.md

@@ -44,7 +44,7 @@ Yarn workspace monorepo:
 - ESLint config: root `.eslintrc.json` (`@typescript-eslint`, warns on unused
   vars, `prefer-const`).
 - Prettier: root `.prettierrc` (single quotes, semi, trailing commas, 80 print
-  width). Run `npx prettier --check <paths>` / `--write` before committing.
+  width). Run `npm run prettier -- -w /path/to/file <paths>` / `--write` before committing.
 
 ## Code Conventions
 

packages/sdk-angular/README.md

@@ -12,6 +12,7 @@ An SDK for using FusionAuth in Angular applications.
   -   [State Parameter](#state-parameter)
   -   [SSR](#ssr)
   -   [DPoP Mode](#dpop-mode)
+    -   [Resource Server Guidance](#resource-server-guidance)
 -   [Known issues](#known-issues)
 -   [Documentation](#documentation)
 -   [Releases](#releases)
@@ -221,6 +222,16 @@ class AppComponent {
 }
 ```
 
+#### Resource Server Guidance
+
+If you're building a resource server that validates FusionAuth-issued DPoP tokens (this guidance applies regardless of which SDK, if any, the resource server itself uses):
+
+- This SDK does not implement `jti` replay prevention — tracking which proof JTIs have already been seen, and rejecting duplicates, is the resource server's responsibility.
+  - Single-instance deployments: an in-memory `Map` with TTL-based eviction is sufficient.
+  - Horizontally scaled deployments: a distributed store (e.g. Redis) is required, since replay state must be shared across instances.
+- Validate the proof's `htu` claim against the request's actual URL. If the resource server sits behind a reverse proxy, ensure it's configured to trust the proxy and expose the public-facing URL (not an internal one) for this comparison.
+- The `Authorization` header uses the `DPoP` scheme, not `Bearer` — resource servers must accept `Authorization: DPoP <token>`.
+
 ### Known Issues
 
 None.

packages/sdk-angular/docs/README.md

@@ -1,4 +1,6 @@
-@fusionauth/angular-sdk / [Exports](modules.md)
+**@fusionauth/angular-sdk**
+
+---
 
 # FusionauthAngularSdk
 

packages/sdk-angular/docs/classes/FusionAuthAccountButtonComponent.md

@@ -1,61 +1,43 @@
-[@fusionauth/angular-sdk](../README.md) / [Exports](../modules.md) / FusionAuthAccountButtonComponent
+[**@fusionauth/angular-sdk**](../README.md)
 
-# Class: FusionAuthAccountButtonComponent
-
-## Table of contents
-
-### Constructors
-
-- [constructor](FusionAuthAccountButtonComponent.md#constructor)
-
-### Properties
+---
 
-- [fusionAuth](FusionAuthAccountButtonComponent.md#fusionauth)
+[@fusionauth/angular-sdk](../globals.md) / FusionAuthAccountButtonComponent
 
-### Methods
+# Class: FusionAuthAccountButtonComponent
 
-- [manageAccount](FusionAuthAccountButtonComponent.md#manageaccount)
+Defined in: [components/fusionauth-account.button/fusion-auth-account-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L10)
 
 ## Constructors
 
-### constructor
-
-• **new FusionAuthAccountButtonComponent**(`fusionAuth`): [`FusionAuthAccountButtonComponent`](FusionAuthAccountButtonComponent.md)
-
-#### Parameters
-
-| Name         | Type                                                                                   |
-| :----------- | :------------------------------------------------------------------------------------- |
-| `fusionAuth` | [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\> |
-
-#### Returns
+### Constructor
 
-[`FusionAuthAccountButtonComponent`](FusionAuthAccountButtonComponent.md)
+```ts
+new FusionAuthAccountButtonComponent(fusionAuth): FusionAuthAccountButtonComponent;
+```
 
-#### Defined in
+Defined in: [components/fusionauth-account.button/fusion-auth-account-button.component.ts:11](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L11)
 
-[lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L10)
-
-## Properties
+#### Parameters
 
-### fusionAuth
+##### fusionAuth
 
-• `Private` **fusionAuth**: [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\>
+[`FusionAuthService`](FusionAuthService.md)
 
-#### Defined in
+#### Returns
 
-[lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L10)
+`FusionAuthAccountButtonComponent`
 
 ## Methods
 
-### manageAccount
+### manageAccount()
+
+```ts
+manageAccount(): void;
+```
 
-▸ **manageAccount**(): `void`
+Defined in: [components/fusionauth-account.button/fusion-auth-account-button.component.ts:13](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L13)
 
 #### Returns
 
 `void`
-
-#### Defined in
-
-[lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts:12](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-account.button/fusion-auth-account-button.component.ts#L12)

packages/sdk-angular/docs/classes/FusionAuthLoginButtonComponent.md

@@ -1,72 +1,53 @@
-[@fusionauth/angular-sdk](../README.md) / [Exports](../modules.md) / FusionAuthLoginButtonComponent
+[**@fusionauth/angular-sdk**](../README.md)
 
-# Class: FusionAuthLoginButtonComponent
-
-## Table of contents
-
-### Constructors
-
-- [constructor](FusionAuthLoginButtonComponent.md#constructor)
-
-### Properties
+---
 
-- [fusionAuth](FusionAuthLoginButtonComponent.md#fusionauth)
-- [state](FusionAuthLoginButtonComponent.md#state)
+[@fusionauth/angular-sdk](../globals.md) / FusionAuthLoginButtonComponent
 
-### Methods
+# Class: FusionAuthLoginButtonComponent
 
-- [login](FusionAuthLoginButtonComponent.md#login)
+Defined in: [components/fusionauth-login.button/fusion-auth-login-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L10)
 
 ## Constructors
 
-### constructor
+### Constructor
+
+```ts
+new FusionAuthLoginButtonComponent(fusionAuth): FusionAuthLoginButtonComponent;
+```
 
-• **new FusionAuthLoginButtonComponent**(`fusionAuth`): [`FusionAuthLoginButtonComponent`](FusionAuthLoginButtonComponent.md)
+Defined in: [components/fusionauth-login.button/fusion-auth-login-button.component.ts:13](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L13)
 
 #### Parameters
 
-| Name         | Type                                                                                   |
-| :----------- | :------------------------------------------------------------------------------------- |
-| `fusionAuth` | [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\> |
+##### fusionAuth
 
-#### Returns
+[`FusionAuthService`](FusionAuthService.md)
 
-[`FusionAuthLoginButtonComponent`](FusionAuthLoginButtonComponent.md)
-
-#### Defined in
+#### Returns
 
-[lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts:12](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L12)
+`FusionAuthLoginButtonComponent`
 
 ## Properties
 
-### fusionAuth
-
-• `Private` **fusionAuth**: [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\>
-
-#### Defined in
-
-[lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts:12](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L12)
-
----
-
 ### state
 
-• **state**: `undefined` \| `string`
-
-#### Defined in
+```ts
+state: string | undefined;
+```
 
-[lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L10)
+Defined in: [components/fusionauth-login.button/fusion-auth-login-button.component.ts:11](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L11)
 
 ## Methods
 
-### login
+### login()
+
+```ts
+login(): void;
+```
 
-▸ **login**(): `void`
+Defined in: [components/fusionauth-login.button/fusion-auth-login-button.component.ts:15](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L15)
 
 #### Returns
 
 `void`
-
-#### Defined in
-
-[lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts:14](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-login.button/fusion-auth-login-button.component.ts#L14)

packages/sdk-angular/docs/classes/FusionAuthLogoutButtonComponent.md

@@ -1,61 +1,43 @@
-[@fusionauth/angular-sdk](../README.md) / [Exports](../modules.md) / FusionAuthLogoutButtonComponent
+[**@fusionauth/angular-sdk**](../README.md)
 
-# Class: FusionAuthLogoutButtonComponent
-
-## Table of contents
-
-### Constructors
-
-- [constructor](FusionAuthLogoutButtonComponent.md#constructor)
-
-### Properties
+---
 
-- [fusionAuth](FusionAuthLogoutButtonComponent.md#fusionauth)
+[@fusionauth/angular-sdk](../globals.md) / FusionAuthLogoutButtonComponent
 
-### Methods
+# Class: FusionAuthLogoutButtonComponent
 
-- [logout](FusionAuthLogoutButtonComponent.md#logout)
+Defined in: [components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:13](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L13)
 
 ## Constructors
 
-### constructor
-
-• **new FusionAuthLogoutButtonComponent**(`fusionAuth`): [`FusionAuthLogoutButtonComponent`](FusionAuthLogoutButtonComponent.md)
-
-#### Parameters
-
-| Name         | Type                                                                                   |
-| :----------- | :------------------------------------------------------------------------------------- |
-| `fusionAuth` | [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\> |
-
-#### Returns
+### Constructor
 
-[`FusionAuthLogoutButtonComponent`](FusionAuthLogoutButtonComponent.md)
+```ts
+new FusionAuthLogoutButtonComponent(fusionAuth): FusionAuthLogoutButtonComponent;
+```
 
-#### Defined in
+Defined in: [components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:14](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L14)
 
-[lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L10)
-
-## Properties
+#### Parameters
 
-### fusionAuth
+##### fusionAuth
 
-• `Private` **fusionAuth**: [`FusionAuthService`](FusionAuthService.md)\<[`UserInfo`](../interfaces/UserInfo.md)\>
+[`FusionAuthService`](FusionAuthService.md)
 
-#### Defined in
+#### Returns
 
-[lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:10](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L10)
+`FusionAuthLogoutButtonComponent`
 
 ## Methods
 
-### logout
+### logout()
+
+```ts
+logout(): void;
+```
 
-▸ **logout**(): `void`
+Defined in: [components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:16](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L16)
 
 #### Returns
 
 `void`
-
-#### Defined in
-
-[lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts:12](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/components/fusionauth-logout.button/fusion-auth-logout-button.component.ts#L12)

packages/sdk-angular/docs/classes/FusionAuthModule.md

@@ -1,43 +1,41 @@
-[@fusionauth/angular-sdk](../README.md) / [Exports](../modules.md) / FusionAuthModule
+[**@fusionauth/angular-sdk**](../README.md)
 
-# Class: FusionAuthModule
-
-## Table of contents
+---
 
-### Constructors
+[@fusionauth/angular-sdk](../globals.md) / FusionAuthModule
 
-- [constructor](FusionAuthModule.md#constructor)
-
-### Methods
+# Class: FusionAuthModule
 
-- [forRoot](FusionAuthModule.md#forroot)
+Defined in: [fusion-auth.module.ts:25](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/fusion-auth.module.ts#L25)
 
 ## Constructors
 
-### constructor
+### Constructor
 
-• **new FusionAuthModule**(): [`FusionAuthModule`](FusionAuthModule.md)
+```ts
+new FusionAuthModule(): FusionAuthModule;
+```
 
 #### Returns
 
-[`FusionAuthModule`](FusionAuthModule.md)
+`FusionAuthModule`
 
 ## Methods
 
-### forRoot
+### forRoot()
 
-▸ **forRoot**(`fusionAuthConfig`): `ModuleWithProviders`\<[`FusionAuthModule`](FusionAuthModule.md)\>
+```ts
+static forRoot(fusionAuthConfig): ModuleWithProviders<FusionAuthModule>;
+```
 
-#### Parameters
+Defined in: [fusion-auth.module.ts:26](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/ee8adbc65b4bc7586f80efa86002158c90d78a7e/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/fusion-auth.module.ts#L26)
 
-| Name               | Type                                                    |
-| :----------------- | :------------------------------------------------------ |
-| `fusionAuthConfig` | [`FusionAuthConfig`](../interfaces/FusionAuthConfig.md) |
+#### Parameters
 
-#### Returns
+##### fusionAuthConfig
 
-`ModuleWithProviders`\<[`FusionAuthModule`](FusionAuthModule.md)\>
+[`FusionAuthConfig`](../interfaces/FusionAuthConfig.md)
 
-#### Defined in
+#### Returns
 
-[lib/fusion-auth.module.ts:26](https://github.com/FusionAuth/fusionauth-javascript-sdk/blob/80c01c9ccb450a2187bc0d2cc65fa8c9c38cfabe/packages/sdk-angular/projects/fusionauth-angular-sdk/src/lib/fusion-auth.module.ts#L26)
+`ModuleWithProviders`\<`FusionAuthModule`\>