Class OIDCAuth

Index

Constructors

Methods

addTokenListener buildAuthCodeUrl devicePoll deviceStart exchangeAuthCode generatePKCE loadConfig passwordGrant refresh setClient setScope startDeviceAuth fromMintInfo

Constructors

constructor

new OIDCAuth(discoveryUrl: string, opts?: OIDCAuthOptions): OIDCAuth
Parameters
- discoveryUrl: string
- Optionalopts: OIDCAuthOptions
Returns OIDCAuth
- Defined in src/auth/OIDCAuth.ts:62

Methods

addTokenListener

addTokenListener(fn: (t: TokenResponse) => void | Promise<void>): void
Subscribe to token updates. Listeners are called after the primary onTokens callback.
Parameters
- fn: (t: TokenResponse) => void | Promise<void>
Returns void
- Defined in src/auth/OIDCAuth.ts:81

buildAuthCodeUrl

buildAuthCodeUrl(
    input: {
        codeChallenge: string;
        codeChallengeMethod?: "S256" | "plain";
        redirectUri: string;
        scope?: string;
        state?: string;
    },
): Promise<string>
Build an Authorization Code + PKCE URL.
Parameters
- input: {
      codeChallenge: string;
      codeChallengeMethod?: "S256" | "plain";
      redirectUri: string;
      scope?: string;
      state?: string;
  }
Returns Promise<string>
- Defined in src/auth/OIDCAuth.ts:135

devicePoll

devicePoll(device_code: string, intervalSec?: number): Promise<TokenResponse>
Parameters
- device_code: string
- intervalSec: number = 5
Returns Promise<TokenResponse>
- Defined in src/auth/OIDCAuth.ts:188

deviceStart

deviceStart(): Promise<DeviceStartResponse>
Returns Promise<DeviceStartResponse>
- Defined in src/auth/OIDCAuth.ts:179

exchangeAuthCode

exchangeAuthCode(
input: { code: string; codeVerifier: string; redirectUri: string },
): Promise<TokenResponse>
Exchange an auth code for tokens, using the PKCE verifier.
Parameters
- input: { code: string; codeVerifier: string; redirectUri: string }
Returns Promise<TokenResponse>
- Defined in src/auth/OIDCAuth.ts:163

generatePKCE

generatePKCE(): { challenge: string; verifier: string }
Generate a PKCE verifier and S256 challenge.
- Verifier: base64url of random bytes, length >= 43, RFC 7636 compliant.
- Challenge: base64url(sha256(verifier))
Returns { challenge: string; verifier: string }
- Defined in src/auth/OIDCAuth.ts:119

loadConfig

loadConfig(): Promise<OIDCConfig>
Returns Promise<OIDCConfig>
- Defined in src/auth/OIDCAuth.ts:87

passwordGrant

passwordGrant(username: string, password: string): Promise<TokenResponse>
Parameters
- username: string
- password: string
Returns Promise<TokenResponse>
- Defined in src/auth/OIDCAuth.ts:283

refresh

refresh(refresh_token: string): Promise<TokenResponse>
Parameters
- refresh_token: string
Returns Promise<TokenResponse>
- Defined in src/auth/OIDCAuth.ts:269

setClient

setClient(id: string): void
Parameters
- id: string
Returns void
- Defined in src/auth/OIDCAuth.ts:70

setScope

setScope(scope?: string): void
Parameters
- Optionalscope: string
Returns void
- Defined in src/auth/OIDCAuth.ts:74

startDeviceAuth

startDeviceAuth(
    intervalSec?: number,
): Promise<
    DeviceStartResponse & {
        cancel: () => void;
        poll: () => Promise<TokenResponse>;
    },
>
One call convenience for Device Code flow.
Parameters
- intervalSec: number = 5
  Desired polling interval in seconds.
Returns Promise<
    DeviceStartResponse & {
        cancel: () => void;
        poll: () => Promise<TokenResponse>;
    },
>
The start fields and helpers to poll or cancel.

Remarks
Polling interval will be the MAX of intervalSec and Mint interval.
- Defined in src/auth/OIDCAuth.ts:223

`Static`fromMintInfo

fromMintInfo(
    info: {
        nuts: {
            "10"?: { supported: boolean };
            "11"?: { supported: boolean };
            "12"?: { supported: boolean };
            "14"?: { supported: boolean };
            "15"?: { methods: MPPMethod[] };
            "17"?: { supported: WebSocketSupport[] };
            "20"?: { supported: boolean };
            "21"?: {
                client_id: string;
                openid_discovery: string;
                protected_endpoints?: { method: "GET" | "POST"; path: string }[];
            };
            "22"?: {
                bat_max_mint: number;
                protected_endpoints: { method: "GET"
                | "POST"; path: string }[];
            };
            "4": { disabled: boolean; methods: SwapMethod[] };
            "5": { disabled: boolean; methods: SwapMethod[] };
            "7"?: { supported: boolean };
            "8"?: { supported: boolean };
            "9"?: { supported: boolean };
        };
    },
    opts?: OIDCAuthOptions,
): OIDCAuth
Parameters
- info: {
      nuts: {
          "10"?: { supported: boolean };
          "11"?: { supported: boolean };
          "12"?: { supported: boolean };
          "14"?: { supported: boolean };
          "15"?: { methods: MPPMethod[] };
          "17"?: { supported: WebSocketSupport[] };
          "20"?: { supported: boolean };
          "21"?: {
              client_id: string;
              openid_discovery: string;
              protected_endpoints?: { method: "GET" | "POST"; path: string }[];
          };
          "22"?: {
              bat_max_mint: number;
              protected_endpoints: { method: "GET"
              | "POST"; path: string }[];
          };
          "4": { disabled: boolean; methods: SwapMethod[] };
          "5": { disabled: boolean; methods: SwapMethod[] };
          "7"?: { supported: boolean };
          "8"?: { supported: boolean };
          "9"?: { supported: boolean };
      };
  }
- Optionalopts: OIDCAuthOptions
Returns OIDCAuth
- Defined in src/auth/OIDCAuth.ts:53

Class OIDCAuth

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns OIDCAuth

Methods

addTokenListener

Parameters

Returns void

buildAuthCodeUrl

Parameters

Returns Promise<string>

devicePoll

Parameters

Returns Promise<TokenResponse>

deviceStart

Returns Promise<DeviceStartResponse>

exchangeAuthCode

Parameters

Returns Promise<TokenResponse>

generatePKCE

Returns { challenge: string; verifier: string }

loadConfig

Returns Promise<OIDCConfig>

passwordGrant

Parameters

Returns Promise<TokenResponse>

refresh

Parameters

Returns Promise<TokenResponse>

setClient

Parameters

Returns void

setScope

Parameters

Returns void

startDeviceAuth

Parameters

Returns Promise< DeviceStartResponse & { cancel: () => void; poll: () => Promise<TokenResponse>; },>

Remarks

StaticfromMintInfo

Parameters

Returns OIDCAuth

Settings

On This Page

Returns Promise<
DeviceStartResponse & {
cancel: () => void;
poll: () => Promise<TokenResponse>;
},
>

`Static`fromMintInfo