@thinkrun/mcp 0.3.9 → 0.3.11

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 (54) hide show
  1. package/README.md +108 -3
  2. package/dist/bin/thinkrun-connector.d.ts +21 -0
  3. package/dist/bin/thinkrun-connector.d.ts.map +1 -0
  4. package/dist/bin/thinkrun-connector.js +96 -0
  5. package/dist/bin/thinkrun-connector.js.map +1 -0
  6. package/dist/bin/thinkrun-mcp.js +144 -36
  7. package/dist/bin/thinkrun-mcp.js.map +1 -1
  8. package/dist/src/client.d.ts +108 -0
  9. package/dist/src/client.d.ts.map +1 -1
  10. package/dist/src/cloud-client.d.ts +11 -1
  11. package/dist/src/cloud-client.d.ts.map +1 -1
  12. package/dist/src/cloud-client.js +73 -23
  13. package/dist/src/cloud-client.js.map +1 -1
  14. package/dist/src/connector/connector-server.d.ts +17 -0
  15. package/dist/src/connector/connector-server.d.ts.map +1 -0
  16. package/dist/src/connector/connector-server.js +116 -0
  17. package/dist/src/connector/connector-server.js.map +1 -0
  18. package/dist/src/connector/http-connector.d.ts +53 -0
  19. package/dist/src/connector/http-connector.d.ts.map +1 -0
  20. package/dist/src/connector/http-connector.js +352 -0
  21. package/dist/src/connector/http-connector.js.map +1 -0
  22. package/dist/src/connector/identity.d.ts +170 -0
  23. package/dist/src/connector/identity.d.ts.map +1 -0
  24. package/dist/src/connector/identity.js +227 -0
  25. package/dist/src/connector/identity.js.map +1 -0
  26. package/dist/src/connector/oauth-server.d.ts +64 -0
  27. package/dist/src/connector/oauth-server.d.ts.map +1 -0
  28. package/dist/src/connector/oauth-server.js +213 -0
  29. package/dist/src/connector/oauth-server.js.map +1 -0
  30. package/dist/src/connector/oauth-store.d.ts +127 -0
  31. package/dist/src/connector/oauth-store.d.ts.map +1 -0
  32. package/dist/src/connector/oauth-store.js +310 -0
  33. package/dist/src/connector/oauth-store.js.map +1 -0
  34. package/dist/src/connector/rate-limit.d.ts +48 -0
  35. package/dist/src/connector/rate-limit.d.ts.map +1 -0
  36. package/dist/src/connector/rate-limit.js +84 -0
  37. package/dist/src/connector/rate-limit.js.map +1 -0
  38. package/dist/src/extension-proxy-client.d.ts +24 -0
  39. package/dist/src/extension-proxy-client.d.ts.map +1 -1
  40. package/dist/src/extension-proxy-client.js +32 -0
  41. package/dist/src/extension-proxy-client.js.map +1 -1
  42. package/dist/src/local-client.d.ts +24 -0
  43. package/dist/src/local-client.d.ts.map +1 -1
  44. package/dist/src/local-client.js +33 -1
  45. package/dist/src/local-client.js.map +1 -1
  46. package/dist/src/onboarding.d.ts +78 -0
  47. package/dist/src/onboarding.d.ts.map +1 -0
  48. package/dist/src/onboarding.js +406 -0
  49. package/dist/src/onboarding.js.map +1 -0
  50. package/dist/src/server.d.ts +16 -0
  51. package/dist/src/server.d.ts.map +1 -1
  52. package/dist/src/server.js +139 -0
  53. package/dist/src/server.js.map +1 -1
  54. package/package.json +1 -1
@@ -0,0 +1,213 @@
1
+ /**
2
+ * OAuth 2.1 Authorization Server for the connector (PRD 0110 task 2.0).
3
+ *
4
+ * Framework-agnostic: every handler returns a plain {status, headers, body}
5
+ * so it can be unit-tested without a socket and adapted to node:http in
6
+ * http-connector.ts. Implements exactly what the live claude.ai client exercised
7
+ * on 2026-07-07: RFC 9728 PRM, RFC 8414 AS metadata, RFC 7591 DCR, OAuth 2.1
8
+ * authorization_code + refresh_token with PKCE S256 and RFC 8707 resource binding.
9
+ */
10
+ import { canonicalResource, verifyPkceS256 } from './oauth-store.js';
11
+ const json = (status, body, headers = {}) => ({
12
+ status,
13
+ headers: { 'content-type': 'application/json', ...headers },
14
+ body,
15
+ });
16
+ const oauthError = (status, error, description) => json(status, { error, ...(description ? { error_description: description } : {}) });
17
+ export class OAuthServer {
18
+ deps;
19
+ publicUrl;
20
+ scope;
21
+ constructor(deps) {
22
+ this.deps = deps;
23
+ this.publicUrl = deps.publicUrl.replace(/\/$/, '');
24
+ this.scope = deps.defaultScope ?? 'mcp';
25
+ }
26
+ get resourceId() {
27
+ return `${this.publicUrl}/mcp`;
28
+ }
29
+ /** RFC 9728 §5.1 challenge value for a 401 from the MCP endpoint. */
30
+ unauthorizedChallenge() {
31
+ return `Bearer resource_metadata="${this.publicUrl}/.well-known/oauth-protected-resource"`;
32
+ }
33
+ // RFC 9728
34
+ protectedResourceMetadata() {
35
+ return json(200, {
36
+ resource: this.resourceId,
37
+ authorization_servers: [this.publicUrl],
38
+ bearer_methods_supported: ['header'],
39
+ scopes_supported: [this.scope],
40
+ });
41
+ }
42
+ // RFC 8414
43
+ authorizationServerMetadata() {
44
+ return json(200, {
45
+ issuer: this.publicUrl,
46
+ authorization_endpoint: `${this.publicUrl}/authorize`,
47
+ token_endpoint: `${this.publicUrl}/token`,
48
+ registration_endpoint: `${this.publicUrl}/register`,
49
+ response_types_supported: ['code'],
50
+ grant_types_supported: ['authorization_code', 'refresh_token'],
51
+ code_challenge_methods_supported: ['S256'],
52
+ token_endpoint_auth_methods_supported: ['none'],
53
+ scopes_supported: [this.scope],
54
+ });
55
+ }
56
+ // RFC 7591 dynamic client registration
57
+ register(body) {
58
+ const redirect_uris = body?.redirect_uris;
59
+ if (!Array.isArray(redirect_uris) || redirect_uris.length === 0 || !redirect_uris.every((u) => typeof u === 'string')) {
60
+ return oauthError(400, 'invalid_client_metadata', 'redirect_uris (non-empty string array) required');
61
+ }
62
+ let client;
63
+ try {
64
+ client = this.deps.clients.register(redirect_uris, typeof body?.client_name === 'string' ? body.client_name : undefined);
65
+ }
66
+ catch (e) {
67
+ return oauthError(400, 'invalid_redirect_uri', e instanceof Error ? e.message : 'invalid redirect_uri');
68
+ }
69
+ return json(201, {
70
+ client_id: client.client_id,
71
+ client_id_issued_at: Math.floor(client.created / 1000),
72
+ redirect_uris: client.redirect_uris,
73
+ token_endpoint_auth_method: 'none',
74
+ grant_types: ['authorization_code', 'refresh_token'],
75
+ response_types: ['code'],
76
+ });
77
+ }
78
+ /**
79
+ * Validate an /authorize request (client, redirect_uri, response_type, PKCE) WITHOUT
80
+ * resolving identity. Used by the interactive login flow so the connector can stash the
81
+ * request and redirect to the ThinkRun login page before a userId exists.
82
+ */
83
+ prepareAuthorization(query) {
84
+ const client_id = query.get('client_id') ?? '';
85
+ const redirect_uri = query.get('redirect_uri') ?? '';
86
+ const response_type = query.get('response_type') ?? '';
87
+ const state = query.get('state');
88
+ const code_challenge = query.get('code_challenge') ?? '';
89
+ const method = query.get('code_challenge_method') ?? '';
90
+ const resource = query.get('resource');
91
+ const scope = query.get('scope') ?? this.scope;
92
+ const client = this.deps.clients.get(client_id);
93
+ if (!client || !client.redirect_uris.includes(redirect_uri)) {
94
+ return { ok: false, result: oauthError(400, 'invalid_client', 'unknown client_id or unregistered redirect_uri') };
95
+ }
96
+ const fail = (error, description) => {
97
+ const loc = new URL(redirect_uri);
98
+ loc.searchParams.set('error', error);
99
+ if (description)
100
+ loc.searchParams.set('error_description', description);
101
+ if (state)
102
+ loc.searchParams.set('state', state);
103
+ return { status: 302, headers: { location: loc.toString() } };
104
+ };
105
+ if (response_type !== 'code')
106
+ return { ok: false, result: fail('unsupported_response_type') };
107
+ if (method !== 'S256' || !code_challenge)
108
+ return { ok: false, result: fail('invalid_request', 'PKCE S256 required') };
109
+ return { ok: true, request: { client_id, redirect_uri, state, code_challenge, resource, scope } };
110
+ }
111
+ /** Issue an authorization code for a validated request + resolved userId → 302 to redirect_uri. */
112
+ issueCodeForRequest(request, userId) {
113
+ const code = this.deps.codes.issue({
114
+ client_id: request.client_id,
115
+ redirect_uri: request.redirect_uri,
116
+ code_challenge: request.code_challenge,
117
+ resource: request.resource ? canonicalResource(request.resource) : null,
118
+ userId,
119
+ scope: request.scope,
120
+ });
121
+ const loc = new URL(request.redirect_uri);
122
+ loc.searchParams.set('code', code);
123
+ if (request.state)
124
+ loc.searchParams.set('state', request.state);
125
+ return { status: 302, headers: { location: loc.toString() } };
126
+ }
127
+ authError(request, error, description) {
128
+ const loc = new URL(request.redirect_uri);
129
+ loc.searchParams.set('error', error);
130
+ if (description)
131
+ loc.searchParams.set('error_description', description);
132
+ if (request.state)
133
+ loc.searchParams.set('state', request.state);
134
+ return { status: 302, headers: { location: loc.toString() } };
135
+ }
136
+ // OAuth 2.1 authorization endpoint (PKCE + RFC 8707). Inline-approve path (dev) and
137
+ // the identity-redirect path (prod interactive flow handled by the connector).
138
+ async authorize(query) {
139
+ const prepared = this.prepareAuthorization(query);
140
+ if (!prepared.ok)
141
+ return prepared.result;
142
+ const request = prepared.request;
143
+ let decision;
144
+ try {
145
+ decision = await this.deps.identity.beginAuthorization(request);
146
+ }
147
+ catch (e) {
148
+ return this.authError(request, 'access_denied', e instanceof Error ? e.message : 'authorization failed');
149
+ }
150
+ if (decision.type === 'redirect') {
151
+ return { status: 302, headers: { location: decision.location } };
152
+ }
153
+ return this.issueCodeForRequest(request, decision.userId);
154
+ }
155
+ // OAuth 2.1 token endpoint
156
+ async token(form) {
157
+ const grant_type = form.get('grant_type');
158
+ if (grant_type === 'authorization_code')
159
+ return this.tokenAuthCode(form);
160
+ if (grant_type === 'refresh_token')
161
+ return this.tokenRefresh(form);
162
+ return oauthError(400, 'unsupported_grant_type');
163
+ }
164
+ tokenAuthCode(form) {
165
+ const code = form.get('code') ?? '';
166
+ const code_verifier = form.get('code_verifier') ?? '';
167
+ const redirect_uri = form.get('redirect_uri') ?? '';
168
+ const resource = form.get('resource');
169
+ const rec = this.deps.codes.consume(code);
170
+ if (!rec)
171
+ return oauthError(400, 'invalid_grant', 'bad or expired authorization code');
172
+ if (rec.redirect_uri !== redirect_uri)
173
+ return oauthError(400, 'invalid_grant', 'redirect_uri mismatch');
174
+ if (!verifyPkceS256(code_verifier, rec.code_challenge))
175
+ return oauthError(400, 'invalid_grant', 'PKCE verification failed');
176
+ // RFC 8707: if the code was bound to a resource, the token request must match.
177
+ if (rec.resource && resource && canonicalResource(resource) !== rec.resource) {
178
+ return oauthError(400, 'invalid_target', 'resource mismatch');
179
+ }
180
+ const tokens = this.deps.tokens.issue({
181
+ client_id: rec.client_id,
182
+ userId: rec.userId,
183
+ resource: rec.resource ?? (resource ? canonicalResource(resource) : null),
184
+ scope: rec.scope,
185
+ });
186
+ return json(200, tokens);
187
+ }
188
+ tokenRefresh(form) {
189
+ const refresh_token = form.get('refresh_token') ?? '';
190
+ const client_id = form.get('client_id') ?? '';
191
+ const rotated = this.deps.tokens.rotate(refresh_token, client_id);
192
+ if (!rotated)
193
+ return oauthError(400, 'invalid_grant', 'bad or expired refresh_token');
194
+ return json(200, rotated);
195
+ }
196
+ /** Resource-server token check for the MCP endpoint (audience-bound). */
197
+ validateAccessToken(bearer) {
198
+ const rec = bearer ? this.deps.tokens.validate(bearer) : undefined;
199
+ if (!rec) {
200
+ return {
201
+ ok: false,
202
+ result: json(401, { jsonrpc: '2.0', error: { code: -32001, message: 'Unauthorized' }, id: null }, {
203
+ 'www-authenticate': this.unauthorizedChallenge(),
204
+ }),
205
+ };
206
+ }
207
+ if (rec.resource && rec.resource !== this.resourceId) {
208
+ return { ok: false, result: json(403, { jsonrpc: '2.0', error: { code: -32001, message: 'wrong audience' }, id: null }) };
209
+ }
210
+ return { ok: true, rec };
211
+ }
212
+ }
213
+ //# sourceMappingURL=oauth-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-server.js","sourceRoot":"","sources":["../../../src/connector/oauth-server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,127 @@
1
+ /**
2
+ * OAuth 2.1 state stores for the claude.ai-web remote MCP connector (PRD 0110).
3
+ *
4
+ * Holds dynamically-registered clients, one-time authorization codes, and
5
+ * access/refresh tokens. In-memory by design for v1 (single-process AS); the
6
+ * interfaces are narrow so a Redis/Postgres backing can drop in later.
7
+ *
8
+ * Hardening the spike lacked:
9
+ * - DCR dedupe: claude.ai re-registers a fresh client per connection attempt
10
+ * (observed 3x in one session), so identical registrations collapse to one.
11
+ * - GC of expired clients / codes / tokens.
12
+ * - Refresh-token rotation on every use (OAuth 2.1 public-client requirement).
13
+ * - Revocation by token and by userId (kill-switch / link-revoke).
14
+ */
15
+ export type Now = () => number;
16
+ export declare function sha256b64url(input: string): string;
17
+ export interface OAuthClient {
18
+ client_id: string;
19
+ redirect_uris: string[];
20
+ client_name?: string;
21
+ created: number;
22
+ last_seen: number;
23
+ }
24
+ export declare class ClientStore {
25
+ private now;
26
+ /** clients unused for this long are GC'd */
27
+ private ttlMs;
28
+ /**
29
+ * Hard cap on retained clients. `POST /register` is unauthenticated (DCR),
30
+ * so an attacker can flood unique registrations; the cap + LRU eviction bound
31
+ * memory regardless. Edge rate-limiting is still recommended in production.
32
+ */
33
+ private maxSize;
34
+ private byId;
35
+ private byFingerprint;
36
+ constructor(now?: Now,
37
+ /** clients unused for this long are GC'd */
38
+ ttlMs?: number,
39
+ /**
40
+ * Hard cap on retained clients. `POST /register` is unauthenticated (DCR),
41
+ * so an attacker can flood unique registrations; the cap + LRU eviction bound
42
+ * memory regardless. Edge rate-limiting is still recommended in production.
43
+ */
44
+ maxSize?: number);
45
+ /** Evict the least-recently-seen client (LRU) to keep the store bounded. */
46
+ private evictOldest;
47
+ /** Register or return the existing client for an identical registration (dedupe). */
48
+ register(redirect_uris: string[], client_name?: string): OAuthClient;
49
+ get(client_id: string): OAuthClient | undefined;
50
+ gc(): number;
51
+ size(): number;
52
+ }
53
+ export interface AuthCodeRecord {
54
+ client_id: string;
55
+ redirect_uri: string;
56
+ code_challenge: string;
57
+ resource: string | null;
58
+ /** resolved at /authorize time by the identity bridge */
59
+ userId: string;
60
+ scope: string;
61
+ expires: number;
62
+ }
63
+ export declare class CodeStore {
64
+ private now;
65
+ private ttlMs;
66
+ private codes;
67
+ constructor(now?: Now, ttlMs?: number);
68
+ issue(rec: Omit<AuthCodeRecord, 'expires'>): string;
69
+ /** One-time consume: returns the record and deletes it. */
70
+ consume(code: string): AuthCodeRecord | undefined;
71
+ gc(): number;
72
+ }
73
+ export interface AccessTokenRecord {
74
+ client_id: string;
75
+ userId: string;
76
+ resource: string | null;
77
+ scope: string;
78
+ expires: number;
79
+ }
80
+ export interface IssuedTokens {
81
+ access_token: string;
82
+ refresh_token: string;
83
+ expires_in: number;
84
+ token_type: 'Bearer';
85
+ scope: string;
86
+ }
87
+ export declare class TokenStore {
88
+ private now;
89
+ private accessTtlMs;
90
+ private refreshTtlMs;
91
+ /** Cap live tokens per user — a refresh-rotation loop can't accumulate memory. */
92
+ private maxPerUser;
93
+ /** Global cap across all users (defense in depth). */
94
+ private maxTotal;
95
+ private access;
96
+ private refresh;
97
+ constructor(now?: Now, accessTtlMs?: number, refreshTtlMs?: number,
98
+ /** Cap live tokens per user — a refresh-rotation loop can't accumulate memory. */
99
+ maxPerUser?: number,
100
+ /** Global cap across all users (defense in depth). */
101
+ maxTotal?: number);
102
+ private countUserAccess;
103
+ /** Evict a user's oldest-expiring access token (+ any refresh paired to it). */
104
+ private evictOldestForUser;
105
+ private evictGlobalOldest;
106
+ issue(params: {
107
+ client_id: string;
108
+ userId: string;
109
+ resource: string | null;
110
+ scope: string;
111
+ }): IssuedTokens;
112
+ /** Validate an access token for use at the resource server. */
113
+ validate(access_token: string): AccessTokenRecord | undefined;
114
+ /** OAuth 2.1 public-client refresh: single-use, rotates the refresh token. */
115
+ rotate(refresh_token: string, client_id: string): IssuedTokens | undefined;
116
+ revokeToken(t: string): void;
117
+ /** Kill-switch / link-revoke: drop every token for a user. Returns count. */
118
+ revokeUser(userId: string): number;
119
+ /** Drop every token (flag off). */
120
+ revokeAll(): void;
121
+ gc(): number;
122
+ }
123
+ export declare function assertHttpsOrLocalhost(uri: string): void;
124
+ /** RFC 8707 canonical resource comparison (drop trailing slash). */
125
+ export declare function canonicalResource(uri: string): string;
126
+ export declare function verifyPkceS256(code_verifier: string, code_challenge: string): boolean;
127
+ //# sourceMappingURL=oauth-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-store.d.ts","sourceRoot":"","sources":["../../../src/connector/oauth-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,310 @@
1
+ /**
2
+ * OAuth 2.1 state stores for the claude.ai-web remote MCP connector (PRD 0110).
3
+ *
4
+ * Holds dynamically-registered clients, one-time authorization codes, and
5
+ * access/refresh tokens. In-memory by design for v1 (single-process AS); the
6
+ * interfaces are narrow so a Redis/Postgres backing can drop in later.
7
+ *
8
+ * Hardening the spike lacked:
9
+ * - DCR dedupe: claude.ai re-registers a fresh client per connection attempt
10
+ * (observed 3x in one session), so identical registrations collapse to one.
11
+ * - GC of expired clients / codes / tokens.
12
+ * - Refresh-token rotation on every use (OAuth 2.1 public-client requirement).
13
+ * - Revocation by token and by userId (kill-switch / link-revoke).
14
+ */
15
+ import { createHash, randomBytes } from 'node:crypto';
16
+ const defaultNow = () => Date.now();
17
+ const b64url = (buf) => buf.toString('base64url');
18
+ const token = (bytes = 32) => `${b64url(randomBytes(bytes))}`;
19
+ export function sha256b64url(input) {
20
+ return createHash('sha256').update(input).digest('base64url');
21
+ }
22
+ const clientFingerprint = (redirect_uris, client_name) => sha256b64url(JSON.stringify({ r: [...redirect_uris].sort(), n: client_name ?? '' }));
23
+ export class ClientStore {
24
+ now;
25
+ ttlMs;
26
+ maxSize;
27
+ byId = new Map();
28
+ byFingerprint = new Map();
29
+ constructor(now = defaultNow,
30
+ /** clients unused for this long are GC'd */
31
+ ttlMs = 30 * 24 * 60 * 60 * 1000,
32
+ /**
33
+ * Hard cap on retained clients. `POST /register` is unauthenticated (DCR),
34
+ * so an attacker can flood unique registrations; the cap + LRU eviction bound
35
+ * memory regardless. Edge rate-limiting is still recommended in production.
36
+ */
37
+ maxSize = 5000) {
38
+ this.now = now;
39
+ this.ttlMs = ttlMs;
40
+ this.maxSize = maxSize;
41
+ }
42
+ /** Evict the least-recently-seen client (LRU) to keep the store bounded. */
43
+ evictOldest() {
44
+ let oldestId;
45
+ let oldest = Infinity;
46
+ for (const [id, c] of this.byId) {
47
+ if (c.last_seen < oldest) {
48
+ oldest = c.last_seen;
49
+ oldestId = id;
50
+ }
51
+ }
52
+ if (oldestId) {
53
+ const c = this.byId.get(oldestId);
54
+ this.byId.delete(oldestId);
55
+ this.byFingerprint.delete(clientFingerprint(c.redirect_uris, c.client_name));
56
+ }
57
+ }
58
+ /** Register or return the existing client for an identical registration (dedupe). */
59
+ register(redirect_uris, client_name) {
60
+ if (redirect_uris.length === 0)
61
+ throw new Error('redirect_uris required');
62
+ for (const uri of redirect_uris)
63
+ assertHttpsOrLocalhost(uri);
64
+ const fp = clientFingerprint(redirect_uris, client_name);
65
+ const existingId = this.byFingerprint.get(fp);
66
+ if (existingId) {
67
+ const existing = this.byId.get(existingId);
68
+ if (existing) {
69
+ existing.last_seen = this.now();
70
+ return existing;
71
+ }
72
+ }
73
+ // Bound memory before inserting a new (non-deduped) client.
74
+ while (this.byId.size >= this.maxSize)
75
+ this.evictOldest();
76
+ const client = {
77
+ client_id: `client_${token(12)}`,
78
+ redirect_uris,
79
+ client_name,
80
+ created: this.now(),
81
+ last_seen: this.now(),
82
+ };
83
+ this.byId.set(client.client_id, client);
84
+ this.byFingerprint.set(fp, client.client_id);
85
+ return client;
86
+ }
87
+ get(client_id) {
88
+ const c = this.byId.get(client_id);
89
+ if (c)
90
+ c.last_seen = this.now();
91
+ return c;
92
+ }
93
+ gc() {
94
+ const cutoff = this.now() - this.ttlMs;
95
+ let removed = 0;
96
+ for (const [id, c] of this.byId) {
97
+ if (c.last_seen < cutoff) {
98
+ this.byId.delete(id);
99
+ this.byFingerprint.delete(clientFingerprint(c.redirect_uris, c.client_name));
100
+ removed++;
101
+ }
102
+ }
103
+ return removed;
104
+ }
105
+ size() {
106
+ return this.byId.size;
107
+ }
108
+ }
109
+ export class CodeStore {
110
+ now;
111
+ ttlMs;
112
+ codes = new Map();
113
+ constructor(now = defaultNow, ttlMs = 60_000) {
114
+ this.now = now;
115
+ this.ttlMs = ttlMs;
116
+ }
117
+ issue(rec) {
118
+ const code = token(24);
119
+ this.codes.set(code, { ...rec, expires: this.now() + this.ttlMs });
120
+ return code;
121
+ }
122
+ /** One-time consume: returns the record and deletes it. */
123
+ consume(code) {
124
+ const rec = this.codes.get(code);
125
+ this.codes.delete(code);
126
+ if (!rec)
127
+ return undefined;
128
+ if (rec.expires < this.now())
129
+ return undefined;
130
+ return rec;
131
+ }
132
+ gc() {
133
+ const t = this.now();
134
+ let removed = 0;
135
+ for (const [c, r] of this.codes)
136
+ if (r.expires < t) {
137
+ this.codes.delete(c);
138
+ removed++;
139
+ }
140
+ return removed;
141
+ }
142
+ }
143
+ export class TokenStore {
144
+ now;
145
+ accessTtlMs;
146
+ refreshTtlMs;
147
+ maxPerUser;
148
+ maxTotal;
149
+ access = new Map();
150
+ refresh = new Map();
151
+ constructor(now = defaultNow, accessTtlMs = 60 * 60 * 1000, refreshTtlMs = 30 * 24 * 60 * 60 * 1000,
152
+ /** Cap live tokens per user — a refresh-rotation loop can't accumulate memory. */
153
+ maxPerUser = 20,
154
+ /** Global cap across all users (defense in depth). */
155
+ maxTotal = 50_000) {
156
+ this.now = now;
157
+ this.accessTtlMs = accessTtlMs;
158
+ this.refreshTtlMs = refreshTtlMs;
159
+ this.maxPerUser = maxPerUser;
160
+ this.maxTotal = maxTotal;
161
+ }
162
+ countUserAccess(userId) {
163
+ let n = 0;
164
+ for (const r of this.access.values())
165
+ if (r.userId === userId)
166
+ n++;
167
+ return n;
168
+ }
169
+ /** Evict a user's oldest-expiring access token (+ any refresh paired to it). */
170
+ evictOldestForUser(userId) {
171
+ let oldestKey;
172
+ let oldest = Infinity;
173
+ for (const [k, r] of this.access)
174
+ if (r.userId === userId && r.expires < oldest) {
175
+ oldest = r.expires;
176
+ oldestKey = k;
177
+ }
178
+ if (oldestKey) {
179
+ this.access.delete(oldestKey);
180
+ for (const [rk, rr] of this.refresh)
181
+ if (rr.access_token === oldestKey) {
182
+ this.refresh.delete(rk);
183
+ break;
184
+ }
185
+ }
186
+ }
187
+ evictGlobalOldest() {
188
+ let oldestKey;
189
+ let oldest = Infinity;
190
+ for (const [k, r] of this.access)
191
+ if (r.expires < oldest) {
192
+ oldest = r.expires;
193
+ oldestKey = k;
194
+ }
195
+ if (oldestKey) {
196
+ this.access.delete(oldestKey);
197
+ for (const [rk, rr] of this.refresh)
198
+ if (rr.access_token === oldestKey) {
199
+ this.refresh.delete(rk);
200
+ break;
201
+ }
202
+ }
203
+ }
204
+ issue(params) {
205
+ // Bound memory: cap per-user and globally before minting.
206
+ while (this.countUserAccess(params.userId) >= this.maxPerUser)
207
+ this.evictOldestForUser(params.userId);
208
+ while (this.access.size >= this.maxTotal)
209
+ this.evictGlobalOldest();
210
+ const access_token = `at_${token(24)}`;
211
+ const refresh_token = `rt_${token(24)}`;
212
+ this.access.set(access_token, { ...params, expires: this.now() + this.accessTtlMs });
213
+ this.refresh.set(refresh_token, { ...params, expires: this.now() + this.refreshTtlMs, access_token });
214
+ return {
215
+ access_token,
216
+ refresh_token,
217
+ expires_in: Math.floor(this.accessTtlMs / 1000),
218
+ token_type: 'Bearer',
219
+ scope: params.scope,
220
+ };
221
+ }
222
+ /** Validate an access token for use at the resource server. */
223
+ validate(access_token) {
224
+ const rec = this.access.get(access_token);
225
+ if (!rec)
226
+ return undefined;
227
+ if (rec.expires < this.now()) {
228
+ this.access.delete(access_token);
229
+ return undefined;
230
+ }
231
+ return rec;
232
+ }
233
+ /** OAuth 2.1 public-client refresh: single-use, rotates the refresh token. */
234
+ rotate(refresh_token, client_id) {
235
+ const rec = this.refresh.get(refresh_token);
236
+ this.refresh.delete(refresh_token); // one-time use — rotation
237
+ if (!rec || rec.expires < this.now())
238
+ return undefined;
239
+ if (rec.client_id !== client_id)
240
+ return undefined;
241
+ // Revoke the superseded access token so a refresh loop can't pile up live tokens.
242
+ this.access.delete(rec.access_token);
243
+ return this.issue({ client_id: rec.client_id, userId: rec.userId, resource: rec.resource, scope: rec.scope });
244
+ }
245
+ revokeToken(t) {
246
+ this.access.delete(t);
247
+ this.refresh.delete(t);
248
+ }
249
+ /** Kill-switch / link-revoke: drop every token for a user. Returns count. */
250
+ revokeUser(userId) {
251
+ let n = 0;
252
+ for (const [k, r] of this.access)
253
+ if (r.userId === userId) {
254
+ this.access.delete(k);
255
+ n++;
256
+ }
257
+ for (const [k, r] of this.refresh)
258
+ if (r.userId === userId) {
259
+ this.refresh.delete(k);
260
+ n++;
261
+ }
262
+ return n;
263
+ }
264
+ /** Drop every token (flag off). */
265
+ revokeAll() {
266
+ this.access.clear();
267
+ this.refresh.clear();
268
+ }
269
+ gc() {
270
+ const t = this.now();
271
+ let removed = 0;
272
+ for (const [k, r] of this.access)
273
+ if (r.expires < t) {
274
+ this.access.delete(k);
275
+ removed++;
276
+ }
277
+ for (const [k, r] of this.refresh)
278
+ if (r.expires < t) {
279
+ this.refresh.delete(k);
280
+ removed++;
281
+ }
282
+ return removed;
283
+ }
284
+ }
285
+ // ---- shared validation ----
286
+ export function assertHttpsOrLocalhost(uri) {
287
+ let u;
288
+ try {
289
+ u = new URL(uri);
290
+ }
291
+ catch {
292
+ throw new Error(`invalid redirect_uri: ${uri}`);
293
+ }
294
+ const isLocalhost = u.hostname === 'localhost' || u.hostname === '127.0.0.1';
295
+ if (u.protocol === 'https:')
296
+ return;
297
+ if (u.protocol === 'http:' && isLocalhost)
298
+ return;
299
+ throw new Error(`redirect_uri must be https or localhost: ${uri}`);
300
+ }
301
+ /** RFC 8707 canonical resource comparison (drop trailing slash). */
302
+ export function canonicalResource(uri) {
303
+ return uri.replace(/\/$/, '');
304
+ }
305
+ export function verifyPkceS256(code_verifier, code_challenge) {
306
+ if (!code_verifier || !code_challenge)
307
+ return false;
308
+ return sha256b64url(code_verifier) === code_challenge;
309
+ }
310
+ //# sourceMappingURL=oauth-store.js.map