Authentication

1
import { HoleFoundationClient } from '@hole-foundation/api';
2
3
const client = new HoleFoundationClient({
4
  environment: 'https://api.theholefoundation.org',
5
  token: access_token
6
});
7
8
const requests = await client.foiaDashboard.listRequests();

1
class TokenManager {
2
  private token: string | null = null;
3
  private expiresAt: number = 0;
4
5
  async getToken(): Promise<string> {
6
    // Return cached token if still valid
7
    if (this.token && Date.now() < this.expiresAt) {
8
      return this.token;
9
    }
10
11
    // Fetch new token
12
    const response = await fetch('https://dev-4fszoklachwdh46m.us.auth0.com/oauth/token', {
13
      method: 'POST',
14
      headers: { 'Content-Type': 'application/json' },
15
      body: JSON.stringify({
16
        grant_type: 'client_credentials',
17
        client_id: process.env.AUTH0_M2M_CLIENT_ID,
18
        client_secret: process.env.AUTH0_M2M_CLIENT_SECRET,
19
        audience: 'https://api.theholefoundation.org'
20
      })
21
    });
22
23
    const { access_token, expires_in } = await response.json();
24
25
    this.token = access_token;
26
    this.expiresAt = Date.now() + (expires_in * 1000) - 60000; // Refresh 1 min early
27
28
    return this.token;
29
  }
30
}
31
32
// Usage
33
const tokenManager = new TokenManager();
34
35
const client = new HoleFoundationClient({
36
  environment: 'https://api.theholefoundation.org',
37
  token: async () => await tokenManager.getToken()
38
});

1
// token-manager.ts
2
import fetch from 'node-fetch';
3
4
export class Auth0TokenManager {
5
  private token: string | null = null;
6
  private expiresAt: number = 0;
7
8
  constructor(
9
    private domain: string,
10
    private clientId: string,
11
    private clientSecret: string,
12
    private audience: string
13
  ) {}
14
15
  async getAccessToken(): Promise<string> {
16
    if (this.token && Date.now() < this.expiresAt) {
17
      return this.token;
18
    }
19
20
    const response = await fetch(`https://${this.domain}/oauth/token`, {
21
      method: 'POST',
22
      headers: { 'Content-Type': 'application/json' },
23
      body: JSON.stringify({
24
        grant_type: 'client_credentials',
25
        client_id: this.clientId,
26
        client_secret: this.clientSecret,
27
        audience: this.audience
28
      })
29
    });
30
31
    if (!response.ok) {
32
      throw new Error(`Auth0 error: ${response.statusText}`);
33
    }
34
35
    const { access_token, expires_in } = await response.json();
36
37
    this.token = access_token;
38
    this.expiresAt = Date.now() + (expires_in * 1000) - 60000;
39
40
    return this.token;
41
  }
42
}
43
44
// app.ts
45
import { HoleFoundationClient } from '@hole-foundation/api';
46
import { Auth0TokenManager } from './token-manager';
47
48
const tokenManager = new Auth0TokenManager(
49
  process.env.AUTH0_DOMAIN!,
50
  process.env.AUTH0_M2M_CLIENT_ID!,
51
  process.env.AUTH0_M2M_CLIENT_SECRET!,
52
  process.env.AUTH0_AUDIENCE!
53
);
54
55
const client = new HoleFoundationClient({
56
  environment: 'https://api.theholefoundation.org',
57
  token: async () => await tokenManager.getAccessToken()
58
});
59
60
// Use the client
61
const requests = await client.foiaDashboard.createRequest({
62
  jurisdiction: 'federal',
63
  subject: 'Freedom of Information Request',
64
  description: 'Request for records regarding...'
65
});