@koshirepo/auth-client 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,27 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # @koshirepo/auth-client
2
+
3
+ The browser side of the auth library. Headless: it has logic and state, and no markup or styling.
4
+
5
+ - Session state as a small state machine: `loading`, `unauthenticated`, `mfa_required`, `authenticated`.
6
+ - The access token is kept in memory only. The refresh token stays in its `HttpOnly` cookie and never reaches script.
7
+ - Automatic refresh, with one request shared between concurrent callers and a lock so tabs take turns.
8
+ - Device binding: a non-extractable key in IndexedDB signs a proof for every request.
9
+ - Password, second-factor and passkey flows, and step-up.
10
+ - Route guards and permission checks that use the same roles and policies as the server.
11
+
12
+ | Import | Contents |
13
+ |---|---|
14
+ | `@koshirepo/auth-client` | `createAuthClient` and its types. Works with any framework, or none. |
15
+ | `@koshirepo/auth-client/react` | `AuthProvider`, `useAuth`, `useLogin`, `useGuard`, `useCan`, `AuthGuard` |
16
+
17
+ Optional peer dependencies: `@simplewebauthn/browser` for passkeys, `react` 18 or later for the hooks.
18
+
19
+ ```ts
20
+ import { createAuthClient } from '@koshirepo/auth-client';
21
+
22
+ const authClient = createAuthClient({ baseUrl: 'https://api.example.com/auth' });
23
+ await authClient.loginWithPassword({ identifier, password });
24
+ const response = await authClient.fetch('https://api.example.com/invoices');
25
+ ```
26
+
27
+ See the [integration guide](../../docs/integration-express.md#6-the-browser-client) and the [API reference](../../docs/api-reference.md#7-koshirepoauth-client).
@@ -0,0 +1,15 @@
1
+ /** What tabs tell each other. Tokens are never sent: each tab gets its own through the cookie. */
2
+ export type ChannelMessage = {
3
+ type: 'signed-in';
4
+ } | {
5
+ type: 'signed-out';
6
+ };
7
+ export interface ChannelLike {
8
+ post(message: ChannelMessage): void;
9
+ /** Registers the listener for messages from other tabs. A tab does not receive its own messages. */
10
+ subscribe(listener: (message: ChannelMessage) => void): void;
11
+ close(): void;
12
+ }
13
+ /** A `BroadcastChannel` between same-origin tabs, or null where the API does not exist. */
14
+ export declare function broadcastChannel(name: string): ChannelLike | null;
15
+ //# sourceMappingURL=channel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,oGAAoG;IACpG,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf;AAOD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAcjE"}
@@ -0,0 +1,23 @@
1
+ function isMessage(value) {
2
+ const type = value?.type;
3
+ return type === 'signed-in' || type === 'signed-out';
4
+ }
5
+ /** A `BroadcastChannel` between same-origin tabs, or null where the API does not exist. */
6
+ export function broadcastChannel(name) {
7
+ if (typeof BroadcastChannel !== 'function')
8
+ return null;
9
+ const channel = new BroadcastChannel(name);
10
+ // In Node an open channel keeps the process alive. Browsers have no `unref`.
11
+ channel.unref?.();
12
+ return {
13
+ post: (message) => channel.postMessage(message),
14
+ subscribe: (listener) => {
15
+ channel.onmessage = (event) => {
16
+ if (isMessage(event.data))
17
+ listener(event.data);
18
+ };
19
+ },
20
+ close: () => channel.close(),
21
+ };
22
+ }
23
+ //# sourceMappingURL=channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAUA,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,YAAY,CAAC;AACvD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,OAAO,gBAAgB,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,6EAA6E;IAC5E,OAA6C,CAAC,KAAK,EAAE,EAAE,CAAC;IACzD,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;QAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,OAAO,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;gBAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;KAC7B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { AuthClient, AuthClientOptions } from './types.js';
2
+ /**
3
+ * Creates the browser client.
4
+ *
5
+ * The access token lives in a variable inside this function. It is not a property of the returned
6
+ * object, is never written to `localStorage`, `sessionStorage`, IndexedDB or a cookie, and is not
7
+ * sent to other tabs. The refresh token never reaches script at all: it stays in its `HttpOnly`
8
+ * cookie.
9
+ */
10
+ export declare function createAuthClient(options: AuthClientOptions): AuthClient;
11
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAA4C,MAAM,YAAY,CAAC;AAuB1G;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAoYvE"}
package/dist/client.js ADDED
@@ -0,0 +1,396 @@
1
+ import { ConfigurationError, MfaError, NetworkError, RequestError, createAuthorizer, errorFromBody, isAuthError, } from '@koshirepo/auth-core';
2
+ import { broadcastChannel } from './channel.js';
3
+ import { DpopSigner, defaultKeyStore } from './dpop.js';
4
+ import { evaluateGuard } from './guards.js';
5
+ import { defaultLocks } from './locks.js';
6
+ function resolveBaseUrl(value) {
7
+ const page = globalThis.location?.href;
8
+ let url;
9
+ try {
10
+ url = page ? new URL(value, page) : new URL(value);
11
+ }
12
+ catch {
13
+ throw new ConfigurationError('CONFIGURATION_INVALID', {
14
+ debug: `baseUrl "${value}" is not an absolute URL, and there is no page URL to resolve it against.`,
15
+ });
16
+ }
17
+ return `${url.origin}${url.pathname}`.replace(/\/+$/, '');
18
+ }
19
+ /**
20
+ * Creates the browser client.
21
+ *
22
+ * The access token lives in a variable inside this function. It is not a property of the returned
23
+ * object, is never written to `localStorage`, `sessionStorage`, IndexedDB or a cookie, and is not
24
+ * sent to other tabs. The refresh token never reaches script at all: it stays in its `HttpOnly`
25
+ * cookie.
26
+ */
27
+ export function createAuthClient(options) {
28
+ const baseUrl = resolveBaseUrl(options.baseUrl);
29
+ const localNow = options.now ?? Date.now;
30
+ const skewMs = (options.refreshSkewSec ?? 30) * 1000;
31
+ const fetchImpl = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
32
+ const locks = options.locks === null ? null : (options.locks ?? defaultLocks());
33
+ const channel = options.channel === null ? null : (options.channel ?? broadcastChannel(`koshi-auth:${baseUrl}`));
34
+ const rbac = options.access?.rbac;
35
+ const authorizer = createAuthorizer({
36
+ ...(rbac ? { rbac } : {}),
37
+ ...(options.access?.policies ? { policies: options.access.policies } : {}),
38
+ });
39
+ // The difference between the server's clock and this device's, learned when the server rejects a
40
+ // proof for its timestamp. DPoP proofs are only valid for about a minute either side of server time.
41
+ let clockOffsetMs = 0;
42
+ const now = () => localNow() + clockOffsetMs;
43
+ const dpop = options.dpop === false
44
+ ? null
45
+ : new DpopSigner(typeof options.dpop === 'object' && options.dpop.keyStore ? options.dpop.keyStore : defaultKeyStore(), now, locks);
46
+ // ---- private state -------------------------------------------------------------------------
47
+ let accessToken = null;
48
+ let mfaTicket = null;
49
+ let state = options.restoreOnStart === false ? { status: 'unauthenticated' } : { status: 'loading' };
50
+ let refreshing = null;
51
+ let disposed = false;
52
+ const listeners = new Set();
53
+ const setState = (next) => {
54
+ state = next;
55
+ for (const listener of [...listeners]) {
56
+ try {
57
+ listener(state);
58
+ }
59
+ catch {
60
+ // One broken subscriber must not stop the others or the login that triggered the change.
61
+ }
62
+ }
63
+ return state;
64
+ };
65
+ const signedOut = () => {
66
+ accessToken = null;
67
+ mfaTicket = null;
68
+ return state.status === 'unauthenticated' ? state : setState({ status: 'unauthenticated' });
69
+ };
70
+ const applyGrant = (grant) => {
71
+ accessToken = { value: grant.accessToken, expiresAtMs: grant.accessTokenExpiresAt * 1000 };
72
+ mfaTicket = null;
73
+ return setState({ status: 'authenticated', user: grant.user, session: grant.session });
74
+ };
75
+ // ---- transport -----------------------------------------------------------------------------
76
+ /** Builds one request, with a fresh proof, and sends it. */
77
+ const dispatch = async (method, url, send) => {
78
+ const headers = new Headers({ accept: 'application/json' });
79
+ let body;
80
+ if (send.body !== undefined) {
81
+ headers.set('content-type', 'application/json');
82
+ body = JSON.stringify(send.body);
83
+ }
84
+ if (send.token !== undefined)
85
+ headers.set('authorization', `${dpop ? 'DPoP' : 'Bearer'} ${send.token}`);
86
+ if (dpop)
87
+ headers.set('dpop', await dpop.proof(method, url, send.token));
88
+ try {
89
+ return await fetchImpl(url, {
90
+ method,
91
+ headers,
92
+ ...(body !== undefined ? { body } : {}),
93
+ credentials: send.withCookie ? 'include' : 'omit',
94
+ });
95
+ }
96
+ catch (cause) {
97
+ throw new NetworkError('NETWORK_ERROR', { cause });
98
+ }
99
+ };
100
+ /**
101
+ * If the server rejected a proof because this device's clock is off, remembers the difference.
102
+ * Returns true when a retry with a corrected timestamp is worthwhile.
103
+ */
104
+ const learnClockOffset = (error) => {
105
+ if (!isAuthError(error) || error.code !== 'DPOP_PROOF_INVALID')
106
+ return false;
107
+ const serverTime = error.details?.serverTime;
108
+ if (typeof serverTime !== 'number')
109
+ return false;
110
+ clockOffsetMs = serverTime * 1000 - localNow();
111
+ return true;
112
+ };
113
+ const readError = async (response) => {
114
+ let payload;
115
+ try {
116
+ payload = await response.json();
117
+ }
118
+ catch {
119
+ payload = undefined;
120
+ }
121
+ return errorFromBody(payload);
122
+ };
123
+ /** Sends a request to an auth endpoint and returns the parsed body, or throws an `AuthError`. */
124
+ const call = async (method, path, send = {}) => {
125
+ const url = `${baseUrl}${path}`;
126
+ let response = await dispatch(method, url, send);
127
+ if (!response.ok) {
128
+ let error = await readError(response);
129
+ if (learnClockOffset(error)) {
130
+ response = await dispatch(method, url, send);
131
+ if (response.ok)
132
+ return (response.status === 204 ? undefined : await response.json());
133
+ error = await readError(response);
134
+ }
135
+ throw error;
136
+ }
137
+ return (response.status === 204 ? undefined : await response.json());
138
+ };
139
+ // ---- refresh -------------------------------------------------------------------------------
140
+ const doRefresh = async () => {
141
+ if (disposed)
142
+ return;
143
+ try {
144
+ applyGrant(await call('POST', '/refresh', { withCookie: true }));
145
+ }
146
+ catch (error) {
147
+ // 401 and 403 mean the session is over. Anything else (offline, server error, throttling)
148
+ // says nothing about the session, so the state is kept and the caller sees the error.
149
+ if (isAuthError(error) && (error.status === 401 || error.status === 403)) {
150
+ signedOut();
151
+ return;
152
+ }
153
+ throw error;
154
+ }
155
+ };
156
+ /**
157
+ * One refresh at a time. Callers inside this page share the request in flight. Across tabs the
158
+ * lock makes refreshes take turns, so two tabs never present the same refresh token, which the
159
+ * server would treat as reuse and answer by revoking the session.
160
+ */
161
+ const refresh = () => {
162
+ refreshing ??= (locks ? locks.request(`koshi-auth:refresh:${baseUrl}`, doRefresh) : doRefresh()).finally(() => {
163
+ refreshing = null;
164
+ });
165
+ return refreshing;
166
+ };
167
+ const initial = state.status === 'loading'
168
+ ? refresh().then(() => (state.status === 'loading' ? signedOut() : state), () => signedOut())
169
+ : Promise.resolve(state);
170
+ const getAccessToken = async (tokenOptions = {}) => {
171
+ await initial;
172
+ if (state.status !== 'authenticated')
173
+ return null;
174
+ if (!tokenOptions.forceRefresh && accessToken && accessToken.expiresAtMs - skewMs > now())
175
+ return accessToken.value;
176
+ await refresh();
177
+ return accessToken?.value ?? null;
178
+ };
179
+ /** A call to an auth endpoint that needs the access token. Refreshes and retries once on a 401. */
180
+ const authed = async (method, path, body) => {
181
+ const token = await getAccessToken();
182
+ if (token === null)
183
+ throw errorFromBody({ code: 'TOKEN_MISSING' });
184
+ const send = (value) => call(method, path, { token: value, ...(body !== undefined ? { body } : {}) });
185
+ try {
186
+ return await send(token);
187
+ }
188
+ catch (error) {
189
+ if (!isAuthError(error) || error.status !== 401 || error.kind !== 'token')
190
+ throw error;
191
+ const fresh = await getAccessToken({ forceRefresh: true });
192
+ if (fresh === null)
193
+ throw error;
194
+ return send(fresh);
195
+ }
196
+ };
197
+ // ---- passkeys ------------------------------------------------------------------------------
198
+ const webauthn = async () => {
199
+ if (options.webauthn)
200
+ return options.webauthn;
201
+ try {
202
+ return (await import('@simplewebauthn/browser'));
203
+ }
204
+ catch (cause) {
205
+ throw new ConfigurationError('CONFIGURATION_INVALID', {
206
+ debug: 'Passkeys need the "@simplewebauthn/browser" package to be installed.',
207
+ cause,
208
+ });
209
+ }
210
+ };
211
+ const completeLogin = (response) => {
212
+ if (response.status === 'authenticated') {
213
+ const next = applyGrant(response);
214
+ channel?.post({ type: 'signed-in' });
215
+ return next;
216
+ }
217
+ accessToken = null;
218
+ mfaTicket = response.ticket;
219
+ return setState({
220
+ status: 'mfa_required',
221
+ methods: response.methods,
222
+ reason: response.reason,
223
+ expiresAt: response.expiresAt,
224
+ });
225
+ };
226
+ // ---- other tabs ----------------------------------------------------------------------------
227
+ channel?.subscribe((message) => {
228
+ if (disposed)
229
+ return;
230
+ if (message.type === 'signed-out')
231
+ signedOut();
232
+ // Another tab signed in: pick the session up through the cookie it set.
233
+ else if (state.status !== 'authenticated')
234
+ void refresh().catch(() => undefined);
235
+ });
236
+ const authContext = (session) => ({
237
+ sessionId: session.id,
238
+ methods: session.methods,
239
+ assurance: session.assurance,
240
+ authenticatedAt: session.authenticatedAt,
241
+ deviceBound: session.deviceBound,
242
+ });
243
+ const client = {
244
+ getState: () => state,
245
+ subscribe(listener) {
246
+ listeners.add(listener);
247
+ return () => {
248
+ listeners.delete(listener);
249
+ };
250
+ },
251
+ ready: () => initial,
252
+ async loginWithPassword(input) {
253
+ await initial;
254
+ return completeLogin(await call('POST', '/login/password', { body: input, withCookie: true }));
255
+ },
256
+ async loginWithPasskey(input = {}) {
257
+ await initial;
258
+ const { challengeId, options: ceremony } = await call('POST', '/login/passkey/options', {
259
+ body: input.identifier === undefined ? {} : { identifier: input.identifier },
260
+ });
261
+ const response = await (await webauthn()).startAuthentication({ optionsJSON: ceremony });
262
+ return completeLogin(await call('POST', '/login/passkey', { body: { challengeId, response }, withCookie: true }));
263
+ },
264
+ async submitMfa(input) {
265
+ if (mfaTicket === null)
266
+ throw new MfaError('MFA_TICKET_INVALID');
267
+ try {
268
+ return completeLogin(await call('POST', '/mfa/verify', {
269
+ body: { ticket: mfaTicket, method: input.method, code: input.code },
270
+ withCookie: true,
271
+ }));
272
+ }
273
+ catch (error) {
274
+ // The ticket is spent or expired: the login has to start again.
275
+ if (isAuthError(error) && error.code === 'MFA_TICKET_INVALID')
276
+ signedOut();
277
+ throw error;
278
+ }
279
+ },
280
+ cancelMfa() {
281
+ if (state.status === 'mfa_required')
282
+ signedOut();
283
+ },
284
+ async reauthenticate(factor) {
285
+ let body;
286
+ if (factor.method === 'passkey') {
287
+ const identifier = state.status === 'authenticated' ? state.user.identifier : undefined;
288
+ const { challengeId, options: ceremony } = await call('POST', '/login/passkey/options', {
289
+ body: identifier === undefined ? {} : { identifier },
290
+ });
291
+ const response = await (await webauthn()).startAuthentication({ optionsJSON: ceremony });
292
+ body = { method: 'passkey', challengeId, response };
293
+ }
294
+ else {
295
+ body = factor;
296
+ }
297
+ return applyGrant(await authed('POST', '/reauthenticate', body));
298
+ },
299
+ async logout(logoutOptions = {}) {
300
+ await initial;
301
+ try {
302
+ await call('POST', logoutOptions.allSessions ? '/logout/all' : '/logout', { withCookie: true });
303
+ }
304
+ finally {
305
+ // This tab is signed out whatever the server said, and so are the others.
306
+ signedOut();
307
+ channel?.post({ type: 'signed-out' });
308
+ }
309
+ },
310
+ getAccessToken,
311
+ async fetch(input, init) {
312
+ // A template is cloned per attempt, so a request with a body can be sent again after a refresh.
313
+ const template = new Request(input, init);
314
+ const attempt = async (token) => {
315
+ const request = template.clone();
316
+ if (token !== null) {
317
+ request.headers.set('authorization', `${dpop ? 'DPoP' : 'Bearer'} ${token}`);
318
+ if (dpop)
319
+ request.headers.set('dpop', await dpop.proof(request.method, request.url, token));
320
+ }
321
+ return fetchImpl(request);
322
+ };
323
+ const token = await getAccessToken();
324
+ const response = await attempt(token);
325
+ if (response.status !== 401 || token === null)
326
+ return response;
327
+ // The token may have expired or been replaced, or this device's clock may be off.
328
+ learnClockOffset(await readError(response.clone()));
329
+ let fresh;
330
+ try {
331
+ fresh = await getAccessToken({ forceRefresh: true });
332
+ }
333
+ catch {
334
+ return response;
335
+ }
336
+ return fresh === null ? response : attempt(fresh);
337
+ },
338
+ mfa: {
339
+ async status() {
340
+ return (await authed('GET', '/session')).security;
341
+ },
342
+ beginTotpEnrollment: () => authed('POST', '/mfa/totp/enroll'),
343
+ confirmTotpEnrollment: (input) => authed('POST', '/mfa/totp/confirm', input),
344
+ removeTotp: () => authed('DELETE', '/mfa/totp'),
345
+ regenerateRecoveryCodes: async () => (await authed('POST', '/mfa/recovery-codes')).recoveryCodes,
346
+ },
347
+ passkeys: {
348
+ async register(input = {}) {
349
+ const { challengeId, options: ceremony } = await authed('POST', '/passkeys/options');
350
+ const response = await (await webauthn()).startRegistration({ optionsJSON: ceremony });
351
+ return authed('POST', '/passkeys', {
352
+ challengeId,
353
+ response,
354
+ ...(input.name !== undefined ? { name: input.name } : {}),
355
+ });
356
+ },
357
+ list: async () => (await authed('GET', '/passkeys')).passkeys,
358
+ remove: (id) => authed('DELETE', `/passkeys/${encodeURIComponent(id)}`),
359
+ },
360
+ sessions: {
361
+ list: async () => (await authed('GET', '/sessions')).sessions,
362
+ async revoke(id) {
363
+ await authed('DELETE', `/sessions/${encodeURIComponent(id)}`);
364
+ if (state.status === 'authenticated' && state.session.id === id) {
365
+ signedOut();
366
+ channel?.post({ type: 'signed-out' });
367
+ }
368
+ },
369
+ },
370
+ changePassword(input) {
371
+ if (typeof input?.currentPassword !== 'string' || typeof input.newPassword !== 'string') {
372
+ return Promise.reject(new RequestError('REQUEST_INVALID'));
373
+ }
374
+ return authed('POST', '/password', input);
375
+ },
376
+ check(requirement = {}) {
377
+ return evaluateGuard(state, requirement, { rbac, nowSec: Math.floor(now() / 1000) });
378
+ },
379
+ can(action, resource, context = {}) {
380
+ if (state.status !== 'authenticated')
381
+ return false;
382
+ return authorizer.can({ id: state.user.id, roles: state.user.roles }, action, resource, {
383
+ ...context,
384
+ auth: authContext(state.session),
385
+ now: Math.floor(now() / 1000),
386
+ });
387
+ },
388
+ dispose() {
389
+ disposed = true;
390
+ listeners.clear();
391
+ channel?.close();
392
+ },
393
+ };
394
+ return client;
395
+ }
396
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/dpop.d.ts ADDED
@@ -0,0 +1,42 @@
1
+ import type { LockManagerLike } from './locks.js';
2
+ /** Where the device key lives between page loads. */
3
+ export interface DpopKeyStore {
4
+ load(): Promise<CryptoKeyPair | null>;
5
+ save(keys: CryptoKeyPair): Promise<void>;
6
+ clear(): Promise<void>;
7
+ }
8
+ /** Keeps the key for the lifetime of the page only. Every reload is a new device to the server. */
9
+ export declare function memoryKeyStore(): DpopKeyStore;
10
+ /**
11
+ * Keeps the key in IndexedDB. `CryptoKey` objects are stored as they are, so the private key
12
+ * never exists as bytes that script could read or send anywhere.
13
+ */
14
+ export declare function indexedDbKeyStore(options?: {
15
+ databaseName?: string;
16
+ }): DpopKeyStore;
17
+ /** IndexedDB where it exists, otherwise memory. */
18
+ export declare function defaultKeyStore(): DpopKeyStore;
19
+ /**
20
+ * Creates the device key on first use and signs DPoP proofs (RFC 9449) with it.
21
+ *
22
+ * The key is ES256, which every browser's WebCrypto supports, and its private half is generated
23
+ * as non-extractable. Script running in the page can ask for a signature but cannot export the key.
24
+ */
25
+ export declare class DpopSigner {
26
+ private readonly store;
27
+ /** Epoch milliseconds, already corrected for any known offset from the server clock. */
28
+ private readonly now;
29
+ private readonly locks;
30
+ private loading;
31
+ constructor(store: DpopKeyStore,
32
+ /** Epoch milliseconds, already corrected for any known offset from the server clock. */
33
+ now: () => number, locks: LockManagerLike | null);
34
+ /** A proof for one request. `accessToken` is included by hash when the request carries one. */
35
+ proof(method: string, url: string, accessToken?: string): Promise<string>;
36
+ /** The RFC 7638 thumbprint the server knows this device by. */
37
+ thumbprint(): Promise<string>;
38
+ private key;
39
+ private loadOrCreate;
40
+ private describe;
41
+ }
42
+ //# sourceMappingURL=dpop.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dpop.d.ts","sourceRoot":"","sources":["../src/dpop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,mGAAmG;AACnG,wBAAgB,cAAc,IAAI,YAAY,CAW7C;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAwCvF;AAED,mDAAmD;AACnD,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAOD;;;;;GAKG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,OAAO,CAAmC;IAElD,YACmB,KAAK,EAAE,YAAY;IACpC,wFAAwF;IACvE,GAAG,EAAE,MAAM,MAAM,EACjB,KAAK,EAAE,eAAe,GAAG,IAAI,EAC5C;IAEJ,+FAA+F;IACzF,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9E;IAED,+DAA+D;IACzD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAElC;IAED,OAAO,CAAC,GAAG;YAQG,YAAY;YAeZ,QAAQ;CAKvB"}