@authfn/oauth-provider 0.0.0 → 0.2.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.
Files changed (70) hide show
  1. package/README.md +97 -1
  2. package/dist/authorize/index.d.ts +5 -0
  3. package/dist/authorize/index.d.ts.map +1 -0
  4. package/dist/authorize/index.js +247 -0
  5. package/dist/authorize/index.js.map +1 -0
  6. package/dist/http.d.ts +35 -0
  7. package/dist/http.d.ts.map +1 -0
  8. package/dist/http.js +161 -0
  9. package/dist/http.js.map +1 -0
  10. package/dist/index.d.ts +23 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +52 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/introspection/index.d.ts +13 -0
  15. package/dist/introspection/index.d.ts.map +1 -0
  16. package/dist/introspection/index.js +47 -0
  17. package/dist/introspection/index.js.map +1 -0
  18. package/dist/metadata/index.d.ts +10 -0
  19. package/dist/metadata/index.d.ts.map +1 -0
  20. package/dist/metadata/index.js +41 -0
  21. package/dist/metadata/index.js.map +1 -0
  22. package/dist/pkce.d.ts +4 -0
  23. package/dist/pkce.d.ts.map +1 -0
  24. package/dist/pkce.js +17 -0
  25. package/dist/pkce.js.map +1 -0
  26. package/dist/registration/document.d.ts +49 -0
  27. package/dist/registration/document.d.ts.map +1 -0
  28. package/dist/registration/document.js +167 -0
  29. package/dist/registration/document.js.map +1 -0
  30. package/dist/registration/index.d.ts +38 -0
  31. package/dist/registration/index.d.ts.map +1 -0
  32. package/dist/registration/index.js +264 -0
  33. package/dist/registration/index.js.map +1 -0
  34. package/dist/registration/metadata.d.ts +27 -0
  35. package/dist/registration/metadata.d.ts.map +1 -0
  36. package/dist/registration/metadata.js +74 -0
  37. package/dist/registration/metadata.js.map +1 -0
  38. package/dist/registration/store.d.ts +82 -0
  39. package/dist/registration/store.d.ts.map +1 -0
  40. package/dist/registration/store.js +187 -0
  41. package/dist/registration/store.js.map +1 -0
  42. package/dist/revocation/index.d.ts +12 -0
  43. package/dist/revocation/index.d.ts.map +1 -0
  44. package/dist/revocation/index.js +34 -0
  45. package/dist/revocation/index.js.map +1 -0
  46. package/dist/runtime.d.ts +64 -0
  47. package/dist/runtime.d.ts.map +1 -0
  48. package/dist/runtime.js +228 -0
  49. package/dist/runtime.js.map +1 -0
  50. package/dist/store.d.ts +155 -0
  51. package/dist/store.d.ts.map +1 -0
  52. package/dist/store.js +467 -0
  53. package/dist/store.js.map +1 -0
  54. package/dist/token/code.d.ts +11 -0
  55. package/dist/token/code.d.ts.map +1 -0
  56. package/dist/token/code.js +64 -0
  57. package/dist/token/code.js.map +1 -0
  58. package/dist/token/index.d.ts +5 -0
  59. package/dist/token/index.d.ts.map +1 -0
  60. package/dist/token/index.js +39 -0
  61. package/dist/token/index.js.map +1 -0
  62. package/dist/token/refresh.d.ts +10 -0
  63. package/dist/token/refresh.d.ts.map +1 -0
  64. package/dist/token/refresh.js +47 -0
  65. package/dist/token/refresh.js.map +1 -0
  66. package/dist/types.d.ts +217 -0
  67. package/dist/types.d.ts.map +1 -0
  68. package/dist/types.js +7 -0
  69. package/dist/types.js.map +1 -0
  70. package/package.json +43 -1
@@ -0,0 +1,264 @@
1
+ import { AuthFnConfigError } from 'authfn/core/errors';
2
+ import { createAuthFnRouteMeta } from 'authfn/http/router';
3
+ import { handleOAuth, OAuthError, oauthJson } from '../http.js';
4
+ import { BodyTimeoutError, declaresMoreThan, fetchMetadataDocument, isMetadataDocumentClientId, readCappedJson } from './document.js';
5
+ import { isPlainObject, readPublicClientMetadata, SUPPORTED_GRANT_TYPES } from './metadata.js';
6
+ import { admitRegistrationEvent, applyDocumentRefetch, claimDocumentRefetch, createDocumentClient, documentClaimId, documentClaimTime, findDocumentClient, findRegisteredClient, insertRegisteredClient, REGISTERED_CLIENT_ID_PREFIX } from './store.js';
7
+ export { createRegistrationSchema } from './store.js';
8
+ export const OAUTH_REGISTRATION_PATH = '/oauth/register';
9
+ const MAX_REGISTRATION_BODY_BYTES = 64 * 1024;
10
+ /** A registration request body must arrive within 5 seconds. */
11
+ export const REGISTRATION_BODY_TIMEOUT_MS = 5000;
12
+ const DEFAULT_LIMITS = { perIp: 20, global: 200, windowSeconds: 3600 };
13
+ /**
14
+ * A metadata document is refetched at most once per 5 minutes across all
15
+ * instances, and kept in memory for up to 1000 clients per process.
16
+ */
17
+ const DOCUMENT_CACHE_MS = 5 * 60 * 1000;
18
+ const DOCUMENT_CACHE_ENTRIES = 1000;
19
+ /** Rejects a malformed `pluginRuntime.oauthProvider.registration` at startup. */
20
+ export function validateRegistrationConfig(registration) {
21
+ if (registration === undefined) {
22
+ return;
23
+ }
24
+ const invalid = (message) => new AuthFnConfigError(`pluginRuntime.oauthProvider.registration ${message}`);
25
+ if (!isPlainObject(registration)) {
26
+ throw invalid('must be an object');
27
+ }
28
+ const { rateLimit, resolveClientIp, fetch: fetchImpl } = registration;
29
+ for (const name of ['dynamic', 'metadataDocuments']) {
30
+ if (registration[name] !== undefined && typeof registration[name] !== 'boolean') {
31
+ throw invalid(`${name} must be a boolean`);
32
+ }
33
+ }
34
+ if ((resolveClientIp !== undefined && typeof resolveClientIp !== 'function') ||
35
+ (fetchImpl !== undefined && typeof fetchImpl !== 'function')) {
36
+ throw invalid('resolveClientIp and fetch must be functions');
37
+ }
38
+ // A public host name can resolve to a private address, so the default
39
+ // fetch could reach internal services: the host must choose the egress.
40
+ if (registration.metadataDocuments === true && fetchImpl === undefined) {
41
+ throw invalid('metadataDocuments requires fetch, one that cannot reach private or internal addresses');
42
+ }
43
+ if (rateLimit !== undefined && (!isPlainObject(rateLimit) || !Object.entries(rateLimit).every(([name, value]) => ['perIp', 'global', 'windowSeconds'].includes(name) &&
44
+ (value === undefined || (typeof value === 'number' && Number.isSafeInteger(value) && value > 0))))) {
45
+ throw invalid('rateLimit takes positive integers perIp, global and windowSeconds');
46
+ }
47
+ }
48
+ function limitsOf(registration) {
49
+ return { ...DEFAULT_LIMITS, ...Object.fromEntries(Object.entries(registration?.rateLimit ?? {}).filter(([, value]) => value !== undefined)) };
50
+ }
51
+ async function clientIp(runtime, request) {
52
+ const resolve = runtime.config.registration?.resolveClientIp ?? runtime.ctx.config.rateLimit?.resolveClientIp;
53
+ const ip = (await resolve?.(request))?.trim();
54
+ return ip || undefined;
55
+ }
56
+ /** Admits one registration event or throws a 429 `temporarily_unavailable`. */
57
+ async function admit(runtime, request, kind) {
58
+ const result = await admitRegistrationEvent(runtime.store, {
59
+ kind,
60
+ ip: await clientIp(runtime, request),
61
+ now: runtime.now(),
62
+ limits: limitsOf(runtime.config.registration)
63
+ });
64
+ if (!result.admitted) {
65
+ throw new OAuthError('temporarily_unavailable', 'Too many client registrations; try again later', 429, {
66
+ 'retry-after': String(result.retryAfterSeconds)
67
+ });
68
+ }
69
+ }
70
+ /** The client metadata of a document that names `clientId` and passes the registration rules. */
71
+ function readDocumentMetadata(clientId, document) {
72
+ if (!isPlainObject(document) || document.client_id !== clientId) {
73
+ return undefined;
74
+ }
75
+ try {
76
+ return readPublicClientMetadata(document);
77
+ }
78
+ catch {
79
+ return undefined;
80
+ }
81
+ }
82
+ function publicClient(clientId, name, redirectUris) {
83
+ return { clientId, name: name ?? clientId, redirectUris, trusted: false, tokenEndpointAuthMethod: 'none' };
84
+ }
85
+ /**
86
+ * Extends `resolveClient` with self-registered clients. A configured client
87
+ * always wins. A `client_id` with the registration prefix is looked up in
88
+ * storage (also after `dynamic` is turned off, which only stops new
89
+ * registrations). With `metadataDocuments`, an `https` URL `client_id` is
90
+ * resolved from the document it serves: the document must name that exact
91
+ * URL as its `client_id` and pass the same public client rules as a
92
+ * registration.
93
+ *
94
+ * The first fetch of an unknown `client_id` counts toward the registration
95
+ * rate limit, and its usable document is stored. A known client is refetched
96
+ * at most once per 5 minutes across all instances, outside that limit, so
97
+ * flooding refuses only new clients and known clients still pick up changed
98
+ * documents. When its host gives no usable answer (network error, timeout,
99
+ * 5xx, 408 or 429), a known client keeps its stored document; any other
100
+ * answer that is not a usable document makes it unknown and drops the row.
101
+ * Only the request holding the current refetch claim stores or drops a
102
+ * result: one that stalled past its claim changes nothing and serves what
103
+ * the newer claim stored.
104
+ */
105
+ export function withClientRegistration(runtime) {
106
+ const documents = new Map();
107
+ const pending = new Map();
108
+ const fetchImpl = runtime.config.registration?.fetch;
109
+ const fetchDocument = (clientId) => fetchImpl ? fetchMetadataDocument(fetchImpl, clientId) : Promise.resolve({ status: 'unavailable' });
110
+ const resolveDocumentClient = (clientId, request) => {
111
+ const cached = documents.get(clientId);
112
+ if (cached && cached.expiresAt > runtime.now().getTime()) {
113
+ return Promise.resolve(cached.client);
114
+ }
115
+ // Concurrent requests for one document share a single load.
116
+ let loading = pending.get(clientId);
117
+ if (!loading) {
118
+ loading = loadDocumentClient(clientId, request).finally(() => pending.delete(clientId));
119
+ pending.set(clientId, loading);
120
+ }
121
+ return loading;
122
+ };
123
+ const remember = (clientId, client, expiresAt) => {
124
+ if (documents.size >= DOCUMENT_CACHE_ENTRIES) {
125
+ documents.delete(documents.keys().next().value);
126
+ }
127
+ documents.set(clientId, { client, expiresAt });
128
+ return client;
129
+ };
130
+ /**
131
+ * Serves a stored document until the refetch claim it carries runs out
132
+ * (at least for a second), or nothing when the client was dropped.
133
+ */
134
+ const serveStored = (stored) => {
135
+ if (!stored) {
136
+ return undefined;
137
+ }
138
+ const expiresAt = Math.max(documentClaimTime(stored.claimId) + DOCUMENT_CACHE_MS, runtime.now().getTime() + 1000);
139
+ return remember(stored.id, publicClient(stored.id, stored.name, stored.redirectUris), expiresAt);
140
+ };
141
+ const loadDocumentClient = async (clientId, request) => {
142
+ documents.delete(clientId);
143
+ const stored = await findDocumentClient(runtime.store, clientId);
144
+ return stored ? loadKnownClient(stored) : loadNewClient(clientId, request);
145
+ };
146
+ const loadKnownClient = async (stored) => {
147
+ const clientId = stored.id;
148
+ const now = runtime.now();
149
+ // Another request claimed the refetch within 5 minutes: use the stored
150
+ // document until that claim runs out.
151
+ const claimId = documentClaimTime(stored.claimId) + DOCUMENT_CACHE_MS > now.getTime()
152
+ ? undefined
153
+ : await claimDocumentRefetch(runtime.store, clientId, now, DOCUMENT_CACHE_MS);
154
+ if (!claimId) {
155
+ return serveStored(stored);
156
+ }
157
+ const fetched = await fetchDocument(clientId);
158
+ if (fetched.status === 'unavailable') {
159
+ // Keep the stored document, as stored now: a later claim may have replaced it.
160
+ return serveStored(await findDocumentClient(runtime.store, clientId));
161
+ }
162
+ const metadata = fetched.status === 'ok' ? readDocumentMetadata(clientId, fetched.document) : undefined;
163
+ // Only the current claim holder stores its result; a superseded refetch
164
+ // serves whatever the newer claim left.
165
+ return serveStored(await applyDocumentRefetch(runtime.store, clientId, claimId, metadata
166
+ ? { name: metadata.name ?? null, redirectUris: metadata.redirectUris, fetchedAt: now }
167
+ : null));
168
+ };
169
+ const loadNewClient = async (clientId, request) => {
170
+ await admit(runtime, request, 'document');
171
+ const now = runtime.now();
172
+ const fetched = await fetchDocument(clientId);
173
+ const metadata = fetched.status === 'ok' ? readDocumentMetadata(clientId, fetched.document) : undefined;
174
+ if (!metadata) {
175
+ return undefined;
176
+ }
177
+ // A concurrent first fetch may have stored the client already; its row is served.
178
+ return serveStored(await createDocumentClient(runtime.store, {
179
+ id: clientId,
180
+ name: metadata.name ?? null,
181
+ redirectUris: metadata.redirectUris,
182
+ fetchedAt: now,
183
+ // This fetch is the client's refetch for the next 5 minutes.
184
+ claimId: documentClaimId(now)
185
+ }));
186
+ };
187
+ return {
188
+ ...runtime,
189
+ resolveClient: async (clientId, request) => {
190
+ const configured = runtime.findClient(clientId);
191
+ if (configured) {
192
+ return configured;
193
+ }
194
+ if (clientId.startsWith(`${REGISTERED_CLIENT_ID_PREFIX}_`)) {
195
+ const record = await findRegisteredClient(runtime.store, clientId);
196
+ return record ? publicClient(record.id, record.name, record.redirectUris) : undefined;
197
+ }
198
+ if (runtime.config.registration?.metadataDocuments && fetchImpl && isMetadataDocumentClientId(clientId)) {
199
+ return resolveDocumentClient(clientId, request);
200
+ }
201
+ return undefined;
202
+ }
203
+ };
204
+ }
205
+ function invalidBody(description) {
206
+ return new OAuthError('invalid_client_metadata', description);
207
+ }
208
+ async function readRegistrationRequest(request) {
209
+ const contentType = request.headers.get('content-type')?.split(';')[0]?.trim().toLowerCase();
210
+ if (contentType !== 'application/json') {
211
+ throw invalidBody('Request body must be application/json');
212
+ }
213
+ if (!request.body || declaresMoreThan(request.headers, MAX_REGISTRATION_BODY_BYTES)) {
214
+ throw invalidBody('Request body must be a JSON object of at most 64 KB');
215
+ }
216
+ try {
217
+ // The deadline bounds how long a request can hold its handler before
218
+ // admission, however slowly it uploads.
219
+ const parsed = await readCappedJson(request.body.getReader(), MAX_REGISTRATION_BODY_BYTES, REGISTRATION_BODY_TIMEOUT_MS);
220
+ if (parsed) {
221
+ return parsed.value;
222
+ }
223
+ }
224
+ catch (error) {
225
+ if (error instanceof BodyTimeoutError) {
226
+ throw invalidBody('Request body must arrive within 5 seconds');
227
+ }
228
+ // Invalid UTF-8 or JSON.
229
+ }
230
+ throw invalidBody('Request body must be a JSON object of at most 64 KB');
231
+ }
232
+ /**
233
+ * RFC 7591 dynamic client registration, when `registration.dynamic` is on.
234
+ * Registers a public client (`token_endpoint_auth_method: none`, no secret)
235
+ * and answers 201 with its metadata. Rate-limited per IP and overall; the
236
+ * body must arrive within 5 seconds.
237
+ * RFC 7592 client management is not offered.
238
+ */
239
+ export function createRegistrationRoutes(runtime) {
240
+ if (!runtime.config.registration?.dynamic) {
241
+ return [];
242
+ }
243
+ return [{
244
+ method: 'POST',
245
+ path: OAUTH_REGISTRATION_PATH,
246
+ meta: createAuthFnRouteMeta('oauthRegister', 'OAuth 2.0 dynamic client registration', { mode: 'none' }),
247
+ handler: (request) => handleOAuth(async () => {
248
+ const metadata = readPublicClientMetadata(await readRegistrationRequest(request));
249
+ await admit(runtime, request, 'register');
250
+ const now = runtime.now();
251
+ const record = await insertRegisteredClient(runtime.store, { ...metadata, now });
252
+ return oauthJson({
253
+ client_id: record.id,
254
+ client_id_issued_at: Math.floor(now.getTime() / 1000),
255
+ ...(metadata.name === undefined ? {} : { client_name: metadata.name }),
256
+ redirect_uris: record.redirectUris,
257
+ token_endpoint_auth_method: 'none',
258
+ grant_types: SUPPORTED_GRANT_TYPES,
259
+ response_types: ['code']
260
+ }, 201);
261
+ })
262
+ }];
263
+ }
264
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registration/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ /** The most redirect URIs one registered client may list. */
2
+ export declare const MAX_REGISTERED_REDIRECT_URIS = 10;
3
+ export declare const SUPPORTED_GRANT_TYPES: string[];
4
+ /** What a self-registered public client is allowed to keep. */
5
+ export interface PublicClientMetadata {
6
+ name?: string;
7
+ redirectUris: string[];
8
+ }
9
+ /**
10
+ * A redirect URI a self-registered client may use: one the configuration
11
+ * would accept (visible ASCII, no fragment, no response parameter in the
12
+ * query, origin written out) that is `https`, or `http` to `127.0.0.1` on any
13
+ * port. Native private-use schemes and `[::1]` are for configured clients only.
14
+ */
15
+ export declare function isRegistrableRedirectUri(value: unknown): value is string;
16
+ /** An object literal or parsed JSON object; not an array, class instance, `Date` or `Map`. */
17
+ export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
18
+ /**
19
+ * Validates client metadata (RFC 7591 2) for a public client: from a dynamic
20
+ * registration request or a Client ID Metadata Document. Only
21
+ * `token_endpoint_auth_method: none` is accepted, and nothing that carries a
22
+ * secret. `grant_types` and `response_types` may only name what this server
23
+ * supports. Other metadata is ignored. Throws `invalid_redirect_uri` or
24
+ * `invalid_client_metadata`.
25
+ */
26
+ export declare function readPublicClientMetadata(body: unknown): PublicClientMetadata;
27
+ //# sourceMappingURL=metadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/registration/metadata.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAI/C,eAAO,MAAM,qBAAqB,UAA0C,CAAC;AAE7E,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMxE;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9E;AAUD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAqC5E"}
@@ -0,0 +1,74 @@
1
+ import { OAuthError } from '../http.js';
2
+ import { isAllowedRedirectUri } from '../runtime.js';
3
+ /** The most redirect URIs one registered client may list. */
4
+ export const MAX_REGISTERED_REDIRECT_URIS = 10;
5
+ const MAX_REDIRECT_URI_LENGTH = 2048;
6
+ const MAX_CLIENT_NAME_LENGTH = 100;
7
+ export const SUPPORTED_GRANT_TYPES = ['authorization_code', 'refresh_token'];
8
+ /**
9
+ * A redirect URI a self-registered client may use: one the configuration
10
+ * would accept (visible ASCII, no fragment, no response parameter in the
11
+ * query, origin written out) that is `https`, or `http` to `127.0.0.1` on any
12
+ * port. Native private-use schemes and `[::1]` are for configured clients only.
13
+ */
14
+ export function isRegistrableRedirectUri(value) {
15
+ if (!isAllowedRedirectUri(value) || value.length > MAX_REDIRECT_URI_LENGTH) {
16
+ return false;
17
+ }
18
+ const url = new URL(value);
19
+ return url.protocol === 'https:' || (url.protocol === 'http:' && url.hostname === '127.0.0.1');
20
+ }
21
+ /** An object literal or parsed JSON object; not an array, class instance, `Date` or `Map`. */
22
+ export function isPlainObject(value) {
23
+ if (typeof value !== 'object' || value === null) {
24
+ return false;
25
+ }
26
+ const prototype = Object.getPrototypeOf(value);
27
+ return prototype === Object.prototype || prototype === null;
28
+ }
29
+ function invalidMetadata(description) {
30
+ return new OAuthError('invalid_client_metadata', description);
31
+ }
32
+ function isStringArray(value) {
33
+ return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
34
+ }
35
+ /**
36
+ * Validates client metadata (RFC 7591 2) for a public client: from a dynamic
37
+ * registration request or a Client ID Metadata Document. Only
38
+ * `token_endpoint_auth_method: none` is accepted, and nothing that carries a
39
+ * secret. `grant_types` and `response_types` may only name what this server
40
+ * supports. Other metadata is ignored. Throws `invalid_redirect_uri` or
41
+ * `invalid_client_metadata`.
42
+ */
43
+ export function readPublicClientMetadata(body) {
44
+ if (!isPlainObject(body)) {
45
+ throw invalidMetadata('Client metadata must be a JSON object');
46
+ }
47
+ const method = body.token_endpoint_auth_method;
48
+ if ((method !== undefined && method !== 'none') || 'client_secret' in body || 'client_secret_expires_at' in body) {
49
+ throw invalidMetadata('Only public clients (token_endpoint_auth_method none, no client secret) can register');
50
+ }
51
+ const redirectUris = body.redirect_uris;
52
+ if (!isStringArray(redirectUris) || redirectUris.length === 0 ||
53
+ redirectUris.length > MAX_REGISTERED_REDIRECT_URIS || !redirectUris.every(isRegistrableRedirectUri)) {
54
+ throw new OAuthError('invalid_redirect_uri', `redirect_uris must list 1 to ${MAX_REGISTERED_REDIRECT_URIS} https or http://127.0.0.1 URIs without a fragment`);
55
+ }
56
+ const grantTypes = body.grant_types;
57
+ if (grantTypes !== undefined && (!isStringArray(grantTypes) || !grantTypes.includes('authorization_code') ||
58
+ !grantTypes.every((grant) => SUPPORTED_GRANT_TYPES.includes(grant)))) {
59
+ throw invalidMetadata('grant_types must include authorization_code and may add only refresh_token');
60
+ }
61
+ const responseTypes = body.response_types;
62
+ if (responseTypes !== undefined &&
63
+ (!isStringArray(responseTypes) || responseTypes.length === 0 || !responseTypes.every((type) => type === 'code'))) {
64
+ throw invalidMetadata('response_types may only be code');
65
+ }
66
+ const name = body.client_name;
67
+ if (name !== undefined && (typeof name !== 'string' || name.trim().length === 0 ||
68
+ // Counted in code points, so a character outside the BMP counts once.
69
+ [...name].length > MAX_CLIENT_NAME_LENGTH || /\p{Cc}/u.test(name))) {
70
+ throw invalidMetadata(`client_name must be 1 to ${MAX_CLIENT_NAME_LENGTH} characters without control characters`);
71
+ }
72
+ return { ...(name === undefined ? {} : { name }), redirectUris: [...new Set(redirectUris)] };
73
+ }
74
+ //# sourceMappingURL=metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/registration/metadata.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,82 @@
1
+ import type { AuthFnRuntimeConfig, AuthFnSchemaDefinition } from 'authfn';
2
+ interface RegistrationStore {
3
+ database: AuthFnRuntimeConfig['database'];
4
+ namespace?: string;
5
+ }
6
+ /** The `client_id` prefix of dynamically registered clients. */
7
+ export declare const REGISTERED_CLIENT_ID_PREFIX = "ocd";
8
+ export declare function createRegistrationSchema(): AuthFnSchemaDefinition['schemas'];
9
+ export interface RegisteredClientRecord {
10
+ id: string;
11
+ name?: string | null;
12
+ redirectUris: string[];
13
+ createdAt: Date;
14
+ }
15
+ export declare function insertRegisteredClient(store: RegistrationStore, input: {
16
+ name?: string;
17
+ redirectUris: string[];
18
+ now: Date;
19
+ }): Promise<RegisteredClientRecord>;
20
+ export declare function findRegisteredClient(store: RegistrationStore, clientId: string): Promise<RegisteredClientRecord | null>;
21
+ /** The last usable metadata document of a `client_id` URL (the record id). */
22
+ export interface DocumentClientRecord {
23
+ id: string;
24
+ name?: string | null;
25
+ redirectUris: string[];
26
+ fetchedAt: Date;
27
+ claimId: string;
28
+ }
29
+ export declare function findDocumentClient(store: RegistrationStore, clientId: string): Promise<DocumentClientRecord | null>;
30
+ /** A refetch claim made at `now`, which sorts after every earlier claim. */
31
+ export declare function documentClaimId(now: Date): string;
32
+ /** The time a refetch claim was made, in milliseconds. */
33
+ export declare function documentClaimTime(claimId: string): number;
34
+ /**
35
+ * Stores a newly fetched document and returns the stored row: this one, or
36
+ * the row another request stored first from its own fetch, which is kept.
37
+ * Row counts are never trusted: not every adapter reports them.
38
+ */
39
+ export declare function createDocumentClient(store: RegistrationStore, record: DocumentClientRecord): Promise<DocumentClientRecord>;
40
+ /**
41
+ * Claims the refetch of a known client's document when no claim was made in
42
+ * the `intervalMs` before `now`, so that across every instance the document
43
+ * is refetched at most once per interval. The claim is a conditional update
44
+ * read back: the caller whose claim ID is stored won and gets that ID.
45
+ */
46
+ export declare function claimDocumentRefetch(store: RegistrationStore, clientId: string, now: Date, intervalMs: number): Promise<string | undefined>;
47
+ /**
48
+ * Applies the result of the refetch claimed as `claimId`: the fetched
49
+ * document, or `null` to drop the client. Only the current claim holder
50
+ * writes; a refetch whose claim was superseded (it stalled past the
51
+ * interval, or another instance's clock leads) changes nothing. Returns the
52
+ * row stored afterwards, read back since row counts are never trusted:
53
+ * this result when it applied, another claim's row, or `null` once dropped.
54
+ */
55
+ export declare function applyDocumentRefetch(store: RegistrationStore, clientId: string, claimId: string, document: Pick<DocumentClientRecord, 'name' | 'redirectUris' | 'fetchedAt'> | null): Promise<DocumentClientRecord | null>;
56
+ export type RegistrationEventKind = 'register' | 'document';
57
+ export interface RegistrationLimits {
58
+ perIp: number;
59
+ global: number;
60
+ windowSeconds: number;
61
+ }
62
+ /**
63
+ * Admits one registration event of `kind` within fixed windows, or reports
64
+ * the seconds until the window ends. The event is stored first and the window
65
+ * counted after, so the event whose insert lands last sees every event
66
+ * admitted before it: concurrent callers never admit more than the limits,
67
+ * though at the boundary they can all refuse. A refused event is deleted, so
68
+ * refusals do not use up the window.
69
+ */
70
+ export declare function admitRegistrationEvent(store: RegistrationStore, input: {
71
+ kind: RegistrationEventKind;
72
+ ip: string | undefined;
73
+ now: Date;
74
+ limits: RegistrationLimits;
75
+ }): Promise<{
76
+ admitted: true;
77
+ } | {
78
+ admitted: false;
79
+ retryAfterSeconds: number;
80
+ }>;
81
+ export {};
82
+ //# sourceMappingURL=store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/registration/store.ts"],"names":[],"mappings":"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"}