@curity/identityserver-haapi-web-driver/README.md

Curity Identity Server HAAPI Web driver

# HAAPI Web Driver

Typescript/Javascript library with classes and functions to access Curity Identity Server [Hypermedia Authentication API (HAAPI)](https://developer.curity.io/docs/latest/developer-guide/haapi/index.html) from browser-based applications. The library is available on the npm public registry and can be installed using:

```
npm install @curity/identityserver-haapi-web-driver
```

## Usage example

The package defines the `createHaapiFetch` function, which creates fetch-like functions that can be used to perform HAAPI requests. The returned functions automatically manage attestation, access tokens, DPoP tokens, and Session-Id under the covers.

```js
// 0 - Import the createHaapiFetch function
import { createHaapiFetch } from '@curity/identityserver-haapi-web-driver';

// 1 - Create a fetch-like function to perform HAAPI requests
const haapiFetch = createHaapiFetch({
    clientId: 'test-client-id',
    tokenEndpoint: 'https://localhost:8443/dev/oauth/token',
});

// 2 - Use haapiFetch to access HAAPI resources
const authorizeRequest = '/dev/oauth/authorize?client_id=test-client-id&response_type=code&scope=read&state=foobar&redirect_uri=https://localhost:7777/client-callback';
haapiFetch(authorizeRequest)
    .then(res => {
        // ...
    });
```