@chapeaux/cpx-state

= Chapeaux User Component

== Events

• user-ready - fires when the .user object data is populated
• user-update - fires when the .user object is updated

== Usage

User data is always stored on the .user property once it is available.

=== Server-side or on-page

.Server-side Data inclusion example [source,html]

----

=== JSON Web Token

Requires that jwt_decode library be available globally.

Available component properties:

• jwt-cookie: sets the cookie to parse for JWT data
• jwt-token: sets the JWT token to parse for data

.JWT Cookie [source,html]

.JWT Token [source,html]

=== Keycloak

Requires keycloak.js to be available, and the following attributes to be set with the appropriate values:

• kc-url - the Keycloak server url
• kc-realm - the Keycloak realm
• kc-client-id - the Keycloak client ID

Available component methods:

• login(): log in using the Keycloak config
• logout(): log out using the Keycloak config
• register(): send user to registration screen based on Keycloak config
• account(): send user to account management screen based on Keycloak config
• token.createLoginUrl(): creates URL to direct user to login screen
• token.createLogoutUrl(): creates URL to log user out

Available component properties:

• token: the Keycloak object for authenticated users

.Keycloak [source,html]

=== Scripts