Skip to content

Commit

Permalink
docs: re-run docs
Browse files Browse the repository at this point in the history
  • Loading branch information
panva committed Feb 6, 2025
1 parent db9fd94 commit 17b531a
Show file tree
Hide file tree
Showing 23 changed files with 35 additions and 35 deletions.
6 changes: 3 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Support from the community to continue maintaining and improving this module is

## Advanced Configuration

- [allowInsecureRequests](functions/allowInsecureRequests.md)
- [~~allowInsecureRequests~~](functions/allowInsecureRequests.md)
- [enableDecryptingResponses](functions/enableDecryptingResponses.md)
- [enableDetachedSignatureResponseChecks](functions/enableDetachedSignatureResponseChecks.md)
- [enableNonRepudiationChecks](functions/enableNonRepudiationChecks.md)
Expand Down Expand Up @@ -141,5 +141,5 @@ Support from the community to continue maintaining and improving this module is
- [clockTolerance](variables/clockTolerance.md)
- [customFetch](variables/customFetch.md)
- [modifyAssertion](variables/modifyAssertion.md)
- [skipStateCheck](variables/skipStateCheck.md)
- [skipSubjectCheck](variables/skipSubjectCheck.md)
- [~~skipStateCheck~~](variables/skipStateCheck.md)
- [~~skipSubjectCheck~~](variables/skipSubjectCheck.md)
2 changes: 1 addition & 1 deletion docs/classes/Configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ let config = new client.Configuration(server, clientId, clientSecret)
| ------ | ------ | ------ |
| `server` | [`ServerMetadata`](../interfaces/ServerMetadata.md) | Authorization Server Metadata |
| `clientId` | `string` | Client Identifier at the Authorization Server |
| `metadata`? | `string` \| [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`ClientMetadata`](../interfaces/ClientMetadata.md)\> | Client Metadata, when a string is passed in it is a shorthand for passing just [ClientMetadata.client_secret](../interfaces/ClientMetadata.md#client_secret). |
| `metadata`? | `string` \| [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`ClientMetadata`](../interfaces/ClientMetadata.md)\> | Client Metadata, when a string is passed in it is a shorthand for passing just [ClientMetadata.client\_secret](../interfaces/ClientMetadata.md#client_secret). |
| `clientAuthentication`? | [`ClientAuth`](../type-aliases/ClientAuth.md) | Implementation of the Client's Authentication Method at the Authorization Server. |

#### Returns
Expand Down
2 changes: 1 addition & 1 deletion docs/functions/TlsClientAuth.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Support from the community to continue maintaining and improving this module is
**`tls_client_auth`** uses the HTTP request body to send only `client_id` as
`application/x-www-form-urlencoded` body parameter and the mTLS key and
certificate is configured through
[ClientMetadata.use_mtls_endpoint_aliases](../interfaces/ClientMetadata.md#use_mtls_endpoint_aliases) and [customFetch](../variables/customFetch.md).
[ClientMetadata.use\_mtls\_endpoint\_aliases](../interfaces/ClientMetadata.md#use_mtls_endpoint_aliases) and [customFetch](../variables/customFetch.md).

## Returns

Expand Down
2 changes: 1 addition & 1 deletion docs/functions/buildAuthorizationUrl.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ must be configured.
| Parameter | Type | Description |
| ------ | ------ | ------ |
| `config` | [`Configuration`](../classes/Configuration.md) | - |
| `parameters` | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)\<`string`, `string`\> \| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams) | Authorization request parameters that will be sent to PAR |
| `parameters` | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)\<`string`, `string`\> \| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams) | Authorization request parameters that will be encoded in the querystring of the URL |

## Returns

Expand Down
2 changes: 1 addition & 1 deletion docs/functions/discovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ NOT RECOMMENDED as it disables the [ServerMetadata.issuer](../interfaces/ServerM
| ------ | ------ | ------ |
| `server` | [`URL`](https://developer.mozilla.org/docs/Web/API/URL) | URL representation of the Authorization Server's Issuer Identifier |
| `clientId` | `string` | Client Identifier at the Authorization Server |
| `metadata`? | `string` \| [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`ClientMetadata`](../interfaces/ClientMetadata.md)\> | Client Metadata, when a string is passed in it is a shorthand for passing just [ClientMetadata.client_secret](../interfaces/ClientMetadata.md#client_secret) |
| `metadata`? | `string` \| [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`ClientMetadata`](../interfaces/ClientMetadata.md)\> | Client Metadata, when a string is passed in it is a shorthand for passing just [ClientMetadata.client\_secret](../interfaces/ClientMetadata.md#client_secret) |
| `clientAuthentication`? | [`ClientAuth`](../type-aliases/ClientAuth.md) | - |
| `options`? | [`DiscoveryRequestOptions`](../interfaces/DiscoveryRequestOptions.md) | |

Expand Down
2 changes: 1 addition & 1 deletion docs/functions/enableNonRepudiationChecks.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Support from the community to continue maintaining and improving this module is
**enableNonRepudiationChecks**(`config`): `void`

Enables validating the JWS Signature of either a JWT [Response.body](https://developer.mozilla.org/docs/Web/API/Response/body) or
[TokenEndpointResponse.id_token](../interfaces/TokenEndpointResponse.md#id_token) of a processed [Response](https://developer.mozilla.org/docs/Web/API/Response) such as
[TokenEndpointResponse.id\_token](../interfaces/TokenEndpointResponse.md#id_token) of a processed [Response](https://developer.mozilla.org/docs/Web/API/Response) such as
JWT UserInfo or JWT Introspection responses.

Note: Validating signatures of JWTs received via direct communication between
Expand Down
4 changes: 2 additions & 2 deletions docs/functions/getDPoPHandle.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,11 @@ negotiating and proving proof-of-possession to sender-constrain OAuth 2.0
tokens via [DPoP](https://www.rfc-editor.org/rfc/rfc9449.html) at the Authorization Server and Resource Server.

Support for [DPoP](https://www.rfc-editor.org/rfc/rfc9449.html) at the authorization is indicated by
[ServerMetadata.dpop_signing_alg_values_supported](../interfaces/ServerMetadata.md#dpop_signing_alg_values_supported). Whether the
[ServerMetadata.dpop\_signing\_alg\_values\_supported](../interfaces/ServerMetadata.md#dpop_signing_alg_values_supported). Whether the
authorization server ends up sender-constraining the access token is at the
server's discretion. When an access token is sender-constrained then the
resulting
[`token_type` will be `dpop`](../interfaces/TokenEndpointResponse.md#token_type).
[\`token\_type\` will be \`dpop\`](../interfaces/TokenEndpointResponse.md#token_type).

This wrapper / handle also keeps track of server-issued nonces, allowing this
module to automatically retry requests with a fresh nonce when the server
Expand Down
4 changes: 2 additions & 2 deletions docs/interfaces/AuthorizationCodeGrantChecks.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,10 +45,10 @@ Note: When `expectedNonce` or `maxAge` is used this has no effect.

`optional` **maxAge**: `number`

ID Token [`auth_time`](IDToken.md#auth_time) claim value will be checked
ID Token [\`auth\_time\`](IDToken.md#auth_time) claim value will be checked
to be present and conform to this `maxAge` value. Use of this option is
required if you sent a `max_age` parameter in the authorization request.
Default is [ClientMetadata.default_max_age](ClientMetadata.md#default_max_age) and falls back to not
Default is [ClientMetadata.default\_max\_age](ClientMetadata.md#default_max_age) and falls back to not
checking the claim's value beyond it being a number when present.

***
Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/AuthorizationDetails.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
12 changes: 6 additions & 6 deletions docs/interfaces/ClientMetadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ that has an effect on how the Client functions

## Indexable

\[`metadata`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`metadata`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down Expand Up @@ -46,7 +46,7 @@ See [clockTolerance](../variables/clockTolerance.md).

JWS `alg` algorithm required for signing authorization responses. When not configured the
default is to allow only algorithms listed in
[`as.authorization_signing_alg_values_supported`](ServerMetadata.md#authorization_signing_alg_values_supported)
[\`as.authorization\_signing\_alg\_values\_supported\`](ServerMetadata.md#authorization_signing_alg_values_supported)
and fall back to `RS256` when the authorization server metadata is not set.

***
Expand All @@ -73,7 +73,7 @@ Default Maximum Authentication Age.

JWS `alg` algorithm required for signing the ID Token issued to this Client. When not
configured the default is to allow only algorithms listed in
[`as.id_token_signing_alg_values_supported`](ServerMetadata.md#id_token_signing_alg_values_supported)
[\`as.id\_token\_signing\_alg\_values\_supported\`](ServerMetadata.md#id_token_signing_alg_values_supported)
and fall back to `RS256` when the authorization server metadata is not set.

***
Expand All @@ -84,7 +84,7 @@ and fall back to `RS256` when the authorization server metadata is not set.

JWS `alg` algorithm REQUIRED for signed introspection responses. When not configured the
default is to allow only algorithms listed in
[`as.introspection_signing_alg_values_supported`](ServerMetadata.md#introspection_signing_alg_values_supported)
[\`as.introspection\_signing\_alg\_values\_supported\`](ServerMetadata.md#introspection_signing_alg_values_supported)
and fall back to `RS256` when the authorization server metadata is not set.

***
Expand All @@ -93,7 +93,7 @@ and fall back to `RS256` when the authorization server metadata is not set.

`optional` **require\_auth\_time**: `boolean`

Boolean value specifying whether the [`auth_time`](IDToken.md#auth_time) Claim in the ID Token
Boolean value specifying whether the [\`auth\_time\`](IDToken.md#auth_time) Claim in the ID Token
is REQUIRED. Default is `false`.

***
Expand Down Expand Up @@ -160,5 +160,5 @@ config[client.customFetch] = (...args) =>

JWS `alg` algorithm REQUIRED for signing UserInfo Responses. When not configured the default is
to allow only algorithms listed in
[`as.userinfo_signing_alg_values_supported`](ServerMetadata.md#userinfo_signing_alg_values_supported)
[\`as.userinfo\_signing\_alg\_values\_supported\`](ServerMetadata.md#userinfo_signing_alg_values_supported)
and fail otherwise.
2 changes: 1 addition & 1 deletion docs/interfaces/ConfirmationClaims.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/DeviceAuthorizationResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/IDToken.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/IntrospectionResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/JWK.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/MTLSEndpointAliases.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`metadata`: `string`\]: `undefined` \| `string`
\[`metadata`: `string`\]: `undefined` \| `string`

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/ServerMetadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Authorization Server Metadata

## Indexable

\[`metadata`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`metadata`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/TokenEndpointResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`parameter`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
8 changes: 4 additions & 4 deletions docs/interfaces/TokenEndpointResponseHelpers.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ Helpers attached to any resolved [TokenEndpointResponse](TokenEndpointResponse.m
**claims**(): `undefined` \| [`IDToken`](IDToken.md)

Returns the parsed JWT Claims Set of an
[id_token](TokenEndpointResponse.md#id_token) returned by the
[id\_token](TokenEndpointResponse.md#id_token) returned by the
authorization server

Note: Returns `undefined` when
[expires_in](TokenEndpointResponse.md#expires_in) was not returned by the
[expires\_in](TokenEndpointResponse.md#expires_in) was not returned by the
authorization server

#### Returns
Expand All @@ -33,12 +33,12 @@ authorization server
**expiresIn**(): `undefined` \| `number`

Returns the number of seconds until the
[access_token](TokenEndpointResponse.md#access_token) expires
[access\_token](TokenEndpointResponse.md#access_token) expires

Note: Returns `0` when already expired

Note: Returns `undefined` when
[expires_in](TokenEndpointResponse.md#expires_in) was not returned by the
[expires\_in](TokenEndpointResponse.md#expires_in) was not returned by the
authorization server

#### Returns
Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/UserInfoAddress.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/UserInfoResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)
\[`claim`: `string`\]: `undefined` \| [`JsonValue`](../type-aliases/JsonValue.md)

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/interfaces/WWWAuthenticateChallengeParameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Support from the community to continue maintaining and improving this module is

## Indexable

\[`parameter`: [`Lowercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#lowercasestringtype)\<`string`\>\]: `undefined` \| `string`
\[`parameter`: [`Lowercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#lowercasestringtype)\<`string`\>\]: `undefined` \| `string`

## Properties

Expand Down
2 changes: 1 addition & 1 deletion docs/type-aliases/ClientAuth.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Support from the community to continue maintaining and improving this module is
Implementation of the Client's Authentication Method at the Authorization
Server.

The default is [ClientSecretPost](../functions/ClientSecretPost.md) if [ClientMetadata.client_secret](../interfaces/ClientMetadata.md#client_secret)
The default is [ClientSecretPost](../functions/ClientSecretPost.md) if [ClientMetadata.client\_secret](../interfaces/ClientMetadata.md#client_secret)
is present, [None](../functions/None.md) otherwise.

Other Client Authentication Methods must be provided explicitly and their
Expand Down

0 comments on commit 17b531a

Please sign in to comment.