agent-recall-mcp 3.5.2 → 3.5.4

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 (219) hide show
  1. package/README.md +254 -143
  2. package/dist/build-server.d.ts +28 -0
  3. package/dist/build-server.d.ts.map +1 -0
  4. package/dist/build-server.js +55 -0
  5. package/dist/build-server.js.map +1 -0
  6. package/dist/http/activity.d.ts +60 -0
  7. package/dist/http/activity.d.ts.map +1 -0
  8. package/dist/http/activity.js +254 -0
  9. package/dist/http/activity.js.map +1 -0
  10. package/dist/http/alerts.d.ts +84 -0
  11. package/dist/http/alerts.d.ts.map +1 -0
  12. package/dist/http/alerts.js +213 -0
  13. package/dist/http/alerts.js.map +1 -0
  14. package/dist/http/cli.d.ts +3 -0
  15. package/dist/http/cli.d.ts.map +1 -0
  16. package/dist/http/cli.js +515 -0
  17. package/dist/http/cli.js.map +1 -0
  18. package/dist/http/export-tar.d.ts +23 -0
  19. package/dist/http/export-tar.d.ts.map +1 -0
  20. package/dist/http/export-tar.js +264 -0
  21. package/dist/http/export-tar.js.map +1 -0
  22. package/dist/http/federation.d.ts +45 -0
  23. package/dist/http/federation.d.ts.map +1 -0
  24. package/dist/http/federation.js +185 -0
  25. package/dist/http/federation.js.map +1 -0
  26. package/dist/http/film/film.css +80 -0
  27. package/dist/http/film/film.js +446 -0
  28. package/dist/http/film/human.jpg +0 -0
  29. package/dist/http/film/m0.jpg +0 -0
  30. package/dist/http/film/m2.jpg +0 -0
  31. package/dist/http/film/m3.jpg +0 -0
  32. package/dist/http/film/wrong.jpg +0 -0
  33. package/dist/http/film.d.ts +16 -0
  34. package/dist/http/film.d.ts.map +1 -0
  35. package/dist/http/film.js +119 -0
  36. package/dist/http/film.js.map +1 -0
  37. package/dist/http/home/cabinet.svg +1 -0
  38. package/dist/http/home/drawer-project.svg +1 -0
  39. package/dist/http/home/drawer-rules.svg +1 -0
  40. package/dist/http/home/drawer-you.svg +1 -0
  41. package/dist/http/home/fig1.svg +242 -0
  42. package/dist/http/home/fig2-1.svg +61 -0
  43. package/dist/http/home/fig2-2.svg +92 -0
  44. package/dist/http/home/fig3.svg +1 -0
  45. package/dist/http/home/home.css +509 -0
  46. package/dist/http/home/home.html +517 -0
  47. package/dist/http/home/icons.svg +15 -0
  48. package/dist/http/home.d.ts +23 -0
  49. package/dist/http/home.d.ts.map +1 -0
  50. package/dist/http/home.js +295 -0
  51. package/dist/http/home.js.map +1 -0
  52. package/dist/http/identities.d.ts +29 -0
  53. package/dist/http/identities.d.ts.map +1 -0
  54. package/dist/http/identities.js +91 -0
  55. package/dist/http/identities.js.map +1 -0
  56. package/dist/http/import-memory.d.ts +161 -0
  57. package/dist/http/import-memory.d.ts.map +1 -0
  58. package/dist/http/import-memory.js +718 -0
  59. package/dist/http/import-memory.js.map +1 -0
  60. package/dist/http/jsonfile.d.ts +6 -0
  61. package/dist/http/jsonfile.d.ts.map +1 -0
  62. package/dist/http/jsonfile.js +60 -0
  63. package/dist/http/jsonfile.js.map +1 -0
  64. package/dist/http/legal/PRIVACY.md +70 -0
  65. package/dist/http/legal.d.ts +10 -0
  66. package/dist/http/legal.d.ts.map +1 -0
  67. package/dist/http/legal.js +35 -0
  68. package/dist/http/legal.js.map +1 -0
  69. package/dist/http/limits.d.ts +59 -0
  70. package/dist/http/limits.d.ts.map +1 -0
  71. package/dist/http/limits.js +163 -0
  72. package/dist/http/limits.js.map +1 -0
  73. package/dist/http/markdown-lite.d.ts +2 -0
  74. package/dist/http/markdown-lite.d.ts.map +1 -0
  75. package/dist/http/markdown-lite.js +86 -0
  76. package/dist/http/markdown-lite.js.map +1 -0
  77. package/dist/http/multipart.d.ts +43 -0
  78. package/dist/http/multipart.d.ts.map +1 -0
  79. package/dist/http/multipart.js +152 -0
  80. package/dist/http/multipart.js.map +1 -0
  81. package/dist/http/oauth-app.d.ts +75 -0
  82. package/dist/http/oauth-app.d.ts.map +1 -0
  83. package/dist/http/oauth-app.js +259 -0
  84. package/dist/http/oauth-app.js.map +1 -0
  85. package/dist/http/oauth-config.d.ts +46 -0
  86. package/dist/http/oauth-config.d.ts.map +1 -0
  87. package/dist/http/oauth-config.js +122 -0
  88. package/dist/http/oauth-config.js.map +1 -0
  89. package/dist/http/oauth-pages.d.ts +40 -0
  90. package/dist/http/oauth-pages.d.ts.map +1 -0
  91. package/dist/http/oauth-pages.js +97 -0
  92. package/dist/http/oauth-pages.js.map +1 -0
  93. package/dist/http/oauth-provider.d.ts +124 -0
  94. package/dist/http/oauth-provider.d.ts.map +1 -0
  95. package/dist/http/oauth-provider.js +486 -0
  96. package/dist/http/oauth-provider.js.map +1 -0
  97. package/dist/http/oauth-store.d.ts +128 -0
  98. package/dist/http/oauth-store.d.ts.map +1 -0
  99. package/dist/http/oauth-store.js +317 -0
  100. package/dist/http/oauth-store.js.map +1 -0
  101. package/dist/http/redirect-policy.d.ts +16 -0
  102. package/dist/http/redirect-policy.d.ts.map +1 -0
  103. package/dist/http/redirect-policy.js +83 -0
  104. package/dist/http/redirect-policy.js.map +1 -0
  105. package/dist/http/review-pages.d.ts +39 -0
  106. package/dist/http/review-pages.d.ts.map +1 -0
  107. package/dist/http/review-pages.js +78 -0
  108. package/dist/http/review-pages.js.map +1 -0
  109. package/dist/http/review.d.ts +36 -0
  110. package/dist/http/review.d.ts.map +1 -0
  111. package/dist/http/review.js +220 -0
  112. package/dist/http/review.js.map +1 -0
  113. package/dist/http/serve.d.ts +58 -0
  114. package/dist/http/serve.d.ts.map +1 -0
  115. package/dist/http/serve.js +324 -0
  116. package/dist/http/serve.js.map +1 -0
  117. package/dist/http/site-pages.d.ts +110 -0
  118. package/dist/http/site-pages.d.ts.map +1 -0
  119. package/dist/http/site-pages.js +630 -0
  120. package/dist/http/site-pages.js.map +1 -0
  121. package/dist/http/site-theme.d.ts +13 -0
  122. package/dist/http/site-theme.d.ts.map +1 -0
  123. package/dist/http/site-theme.js +22 -0
  124. package/dist/http/site-theme.js.map +1 -0
  125. package/dist/http/site.d.ts +52 -0
  126. package/dist/http/site.d.ts.map +1 -0
  127. package/dist/http/site.js +353 -0
  128. package/dist/http/site.js.map +1 -0
  129. package/dist/http/stats.d.ts +139 -0
  130. package/dist/http/stats.d.ts.map +1 -0
  131. package/dist/http/stats.js +599 -0
  132. package/dist/http/stats.js.map +1 -0
  133. package/dist/http/tar-import.d.ts +69 -0
  134. package/dist/http/tar-import.d.ts.map +1 -0
  135. package/dist/http/tar-import.js +234 -0
  136. package/dist/http/tar-import.js.map +1 -0
  137. package/dist/http/tenant-paths.d.ts +14 -0
  138. package/dist/http/tenant-paths.d.ts.map +1 -0
  139. package/dist/http/tenant-paths.js +42 -0
  140. package/dist/http/tenant-paths.js.map +1 -0
  141. package/dist/http/tokens.d.ts +32 -0
  142. package/dist/http/tokens.d.ts.map +1 -0
  143. package/dist/http/tokens.js +137 -0
  144. package/dist/http/tokens.js.map +1 -0
  145. package/dist/http/trial.d.ts +55 -0
  146. package/dist/http/trial.d.ts.map +1 -0
  147. package/dist/http/trial.js +218 -0
  148. package/dist/http/trial.js.map +1 -0
  149. package/dist/http/web-session.d.ts +108 -0
  150. package/dist/http/web-session.d.ts.map +1 -0
  151. package/dist/http/web-session.js +267 -0
  152. package/dist/http/web-session.js.map +1 -0
  153. package/dist/index.js +12 -65
  154. package/dist/index.js.map +1 -1
  155. package/dist/lib/ambient-capture.d.ts.map +1 -1
  156. package/dist/lib/ambient-capture.js +4 -1
  157. package/dist/lib/ambient-capture.js.map +1 -1
  158. package/dist/lib/bookkeeping.d.ts +26 -0
  159. package/dist/lib/bookkeeping.d.ts.map +1 -0
  160. package/dist/lib/bookkeeping.js +31 -0
  161. package/dist/lib/bookkeeping.js.map +1 -0
  162. package/dist/lib/hosted-redact.d.ts +17 -0
  163. package/dist/lib/hosted-redact.d.ts.map +1 -0
  164. package/dist/lib/hosted-redact.js +57 -0
  165. package/dist/lib/hosted-redact.js.map +1 -0
  166. package/dist/lib/lifecycle-exit.d.ts +5 -13
  167. package/dist/lib/lifecycle-exit.d.ts.map +1 -1
  168. package/dist/lib/lifecycle-exit.js +38 -16
  169. package/dist/lib/lifecycle-exit.js.map +1 -1
  170. package/dist/server.d.ts +3 -2
  171. package/dist/server.d.ts.map +1 -1
  172. package/dist/server.js +6 -3
  173. package/dist/server.js.map +1 -1
  174. package/dist/tools/annotations.d.ts +65 -0
  175. package/dist/tools/annotations.d.ts.map +1 -0
  176. package/dist/tools/annotations.js +4 -0
  177. package/dist/tools/annotations.js.map +1 -0
  178. package/dist/tools/check-action.d.ts.map +1 -1
  179. package/dist/tools/check-action.js +2 -0
  180. package/dist/tools/check-action.js.map +1 -1
  181. package/dist/tools/check.d.ts.map +1 -1
  182. package/dist/tools/check.js +6 -2
  183. package/dist/tools/check.js.map +1 -1
  184. package/dist/tools/digest.d.ts.map +1 -1
  185. package/dist/tools/digest.js +2 -0
  186. package/dist/tools/digest.js.map +1 -1
  187. package/dist/tools/pipeline-close.d.ts.map +1 -1
  188. package/dist/tools/pipeline-close.js +2 -0
  189. package/dist/tools/pipeline-close.js.map +1 -1
  190. package/dist/tools/pipeline-current.d.ts.map +1 -1
  191. package/dist/tools/pipeline-current.js +2 -0
  192. package/dist/tools/pipeline-current.js.map +1 -1
  193. package/dist/tools/pipeline-list.d.ts.map +1 -1
  194. package/dist/tools/pipeline-list.js +2 -0
  195. package/dist/tools/pipeline-list.js.map +1 -1
  196. package/dist/tools/pipeline-open.d.ts.map +1 -1
  197. package/dist/tools/pipeline-open.js +2 -0
  198. package/dist/tools/pipeline-open.js.map +1 -1
  199. package/dist/tools/pipeline-show.d.ts.map +1 -1
  200. package/dist/tools/pipeline-show.js +2 -0
  201. package/dist/tools/pipeline-show.js.map +1 -1
  202. package/dist/tools/recall.d.ts.map +1 -1
  203. package/dist/tools/recall.js +4 -1
  204. package/dist/tools/recall.js.map +1 -1
  205. package/dist/tools/register-rule.d.ts.map +1 -1
  206. package/dist/tools/register-rule.js +2 -0
  207. package/dist/tools/register-rule.js.map +1 -1
  208. package/dist/tools/remember.d.ts.map +1 -1
  209. package/dist/tools/remember.js +10 -1
  210. package/dist/tools/remember.js.map +1 -1
  211. package/dist/tools/session-end.d.ts +15 -0
  212. package/dist/tools/session-end.d.ts.map +1 -1
  213. package/dist/tools/session-end.js +13 -1
  214. package/dist/tools/session-end.js.map +1 -1
  215. package/dist/tools/session-start.d.ts +6 -1
  216. package/dist/tools/session-start.d.ts.map +1 -1
  217. package/dist/tools/session-start.js +24 -212
  218. package/dist/tools/session-start.js.map +1 -1
  219. package/package.json +11 -8
@@ -0,0 +1,486 @@
1
+ import { randomBytes, timingSafeEqual } from "node:crypto";
2
+ import { CustomOAuthError, InvalidClientMetadataError, InvalidGrantError, InvalidRequestError, InvalidTargetError, InvalidTokenError, } from "@modelcontextprotocol/sdk/server/auth/errors.js";
3
+ import { isAllowedRedirect } from "./redirect-policy.js";
4
+ import { sha256Hex } from "./oauth-store.js";
5
+ import { FederationError, PROVIDER_LABEL, b64url, formActionOrigins, newPkce } from "./federation.js";
6
+ import { resolveIdentity, IdentityLinkError } from "./identities.js";
7
+ import { errorPage, signInPage, isCustomSchemeSource, pageHeaders as pageHeadersFor } from "./oauth-pages.js";
8
+ export const OAUTH_SCOPE = "memory";
9
+ export const COOKIE_PREFIX = "ar_oauth_";
10
+ /** Longest client-supplied `state` we accept (it is echoed back in redirects). */
11
+ export const MAX_CLIENT_STATE_CHARS = 512;
12
+ /** At most this many provider redirects per sign-in request. */
13
+ export const MAX_STARTS_PER_REQUEST = 3;
14
+ const MAX_LOGGED_SUBJECTS = 10_000;
15
+ export const PENDING_TTL_MS = 10 * 60 * 1000;
16
+ export const CODE_TTL_MS = 60 * 1000;
17
+ const DEFAULT_MAX_PENDING = 10_000;
18
+ /** Live sign-in requests one client address (IPv4, or IPv6 /64) may hold, so one address cannot fill the table. */
19
+ const DEFAULT_MAX_PENDING_PER_KEY = 30;
20
+ const MAX_CODES = 10_000;
21
+ const MAX_CHALLENGE_LOOKUPS = 5;
22
+ const MAX_REDIRECT_URIS = 3;
23
+ const MAX_REDIRECT_URI_CHARS = 1024;
24
+ const CLIENT_NAME_MAX = 100;
25
+ const MSG_DEAD = "This sign-in request is no longer valid (it expired or was already used). Go back to your app and start again.";
26
+ const MSG_BROWSER = "This sign-in must continue in the same browser where it started. Go back to your app and start again.";
27
+ const MSG_STATE = "The sign-in response was not recognized (it may have expired or been used already). Go back to your app and start again.";
28
+ const MSG_BUSY = "The sign-in service is busy right now. Please retry in a few seconds.";
29
+ const MSG_TOO_MANY_STARTS = "Too many sign-in attempts for this request. Go back to your app and start again.";
30
+ const MSG_REJECTED = "Sign-in failed. Please try again, or use another account.";
31
+ const MSG_UNAVAILABLE = "Sign-in is temporarily unavailable. Please try again in a few minutes.";
32
+ const MSG_LINK = "This account cannot sign in because of a server configuration problem. Ask the server operator to check its identity link.";
33
+ const MSG_PER_KEY = "Too many open sign-in requests from your network. Finish or close the open ones, then try again in a few minutes.";
34
+ const notInvited = (provider, subject) => `This ${PROVIDER_LABEL[provider]} account is not invited to this AgentRecall server. ` +
35
+ `To get access, send this id to the server operator: ${provider} ${subject}`;
36
+ const str = (v, max) => typeof v === "string" && v.length > 0 && v.length <= max ? v : null;
37
+ export class FederatedOAuthProvider {
38
+ d;
39
+ clientsStore;
40
+ pending = new Map();
41
+ stateIndex = new Map();
42
+ codes = new Map();
43
+ loggedSubjects = new Set();
44
+ pendingPerKey = new Map();
45
+ maxPendingPerKey;
46
+ providers;
47
+ maxPending;
48
+ /** Origins the sign-in page may redirect its form to (the providers' authorize endpoints). */
49
+ formOrigins;
50
+ constructor(d) {
51
+ this.d = d;
52
+ this.providers = d.federation.enabledProviders();
53
+ this.maxPending = d.maxPending ?? DEFAULT_MAX_PENDING;
54
+ this.maxPendingPerKey = d.maxPendingPerKey ?? DEFAULT_MAX_PENDING_PER_KEY;
55
+ this.formOrigins = formActionOrigins(d.federation.urls, this.providers);
56
+ this.clientsStore = {
57
+ getClient: (id) => this.allowedClient(id),
58
+ registerClient: (info) => this.registerClient(info),
59
+ };
60
+ }
61
+ /** A stored client keeps only the redirect URIs that still pass the policy; none left → unknown client. */
62
+ allowedClient(id) {
63
+ const c = this.d.store.getClient(id);
64
+ if (!c)
65
+ return undefined;
66
+ const uris = (c.redirect_uris ?? []).filter((u) => isAllowedRedirect(String(u), this.d.config.redirectAllow));
67
+ return uris.length === 0 ? undefined : { ...c, redirect_uris: uris };
68
+ }
69
+ /** One cookie per sign-in request, so parallel sign-ins in one browser do not clobber each other. */
70
+ cookieName(requestId) {
71
+ return COOKIE_PREFIX + sha256Hex(requestId).slice(0, 12);
72
+ }
73
+ readCookie(header, requestId) {
74
+ if (!header || header.length > 4096)
75
+ return undefined;
76
+ const name = this.cookieName(requestId);
77
+ for (const part of header.split(";")) {
78
+ const i = part.indexOf("=");
79
+ if (i > 0 && part.slice(0, i).trim() === name)
80
+ return part.slice(i + 1).trim();
81
+ }
82
+ return undefined;
83
+ }
84
+ /** Set-Cookie value for a request's browser-binding cookie (value null clears it). */
85
+ cookieHeader(requestId, value) {
86
+ const secure = this.d.config.publicUrl.protocol === "https:" ? "; Secure" : "";
87
+ return `${this.cookieName(requestId)}=${value ?? ""}; HttpOnly; SameSite=Lax; Path=/authorize; Max-Age=${value === null ? 0 : PENDING_TTL_MS / 1000}${secure}`;
88
+ }
89
+ // ---- registration ------------------------------------------------------
90
+ registerClient(info) {
91
+ const uris = info.redirect_uris;
92
+ if (!Array.isArray(uris) || uris.length === 0 || uris.length > MAX_REDIRECT_URIS) {
93
+ throw new InvalidClientMetadataError(`redirect_uris must list 1-${MAX_REDIRECT_URIS} URIs`);
94
+ }
95
+ for (const u of uris) {
96
+ if (typeof u === "string" && u.length > MAX_REDIRECT_URI_CHARS) {
97
+ throw new InvalidClientMetadataError(`redirect_uri longer than ${MAX_REDIRECT_URI_CHARS} characters`);
98
+ }
99
+ if (!isAllowedRedirect(String(u), this.d.config.redirectAllow)) {
100
+ throw new CustomOAuthError("invalid_redirect_uri", "redirect_uri is not allowed by this server (loopback, claude.ai and operator-approved callbacks only)");
101
+ }
102
+ }
103
+ const rawName = typeof info.client_name === "string" ? info.client_name : "";
104
+ // eslint-disable-next-line no-control-regex
105
+ const name = rawName.replace(/[\u200b-\u200f\u202a-\u202e\u2066-\u2069\ufeff]/g, "").replace(/[\u0000-\u001f\u007f]/g, " ").trim().slice(0, CLIENT_NAME_MAX) || "Unnamed application";
106
+ // Whitelist: nothing else a registrant sends is stored. Always a public client (PKCE, no secret).
107
+ const client = {
108
+ client_id: info.client_id ?? randomBytes(16).toString("hex"),
109
+ client_id_issued_at: info.client_id_issued_at ?? Math.floor(this.d.now() / 1000),
110
+ redirect_uris: uris.map(String),
111
+ client_name: name,
112
+ token_endpoint_auth_method: "none",
113
+ grant_types: ["authorization_code", "refresh_token"],
114
+ response_types: ["code"],
115
+ scope: OAUTH_SCOPE,
116
+ };
117
+ this.d.store.addClient(client);
118
+ const { last_used_at: _omit, ...publicView } = client;
119
+ return publicView;
120
+ }
121
+ // ---- /authorize --------------------------------------------------------
122
+ async authorize(client, params, res) {
123
+ // Never redirect (not even with an error) to a URI the policy refuses.
124
+ if (!isAllowedRedirect(params.redirectUri, this.d.config.redirectAllow)) {
125
+ res.status(400).json(new InvalidRequestError("redirect_uri is not allowed by this server").toResponseObject());
126
+ return;
127
+ }
128
+ if (params.resource && params.resource.href !== this.d.config.resourceUrl.href) {
129
+ throw new InvalidTargetError(`resource must be ${this.d.config.resourceUrl.href}`);
130
+ }
131
+ if (params.state !== undefined && params.state.length > MAX_CLIENT_STATE_CHARS) {
132
+ throw new InvalidRequestError(`state is longer than ${MAX_CLIENT_STATE_CHARS} characters`);
133
+ }
134
+ if (!/^[A-Za-z0-9_-]{43,128}$/.test(params.codeChallenge)) {
135
+ throw new InvalidRequestError("code_challenge is not a valid S256 challenge");
136
+ }
137
+ const cookie = randomBytes(32).toString("base64url");
138
+ const key = this.d.keyOf && res.req ? this.d.keyOf(res.req) : "-";
139
+ if (this.livePendingFor(key) >= this.maxPendingPerKey) {
140
+ res.status(429).set(pageHeadersFor([])).set("retry-after", "60").send(errorPage(MSG_PER_KEY));
141
+ return;
142
+ }
143
+ const id = this.createPending({
144
+ key,
145
+ clientId: client.client_id,
146
+ clientName: client.client_name ?? "Unnamed application",
147
+ redirectUri: params.redirectUri,
148
+ state: params.state,
149
+ codeChallenge: params.codeChallenge,
150
+ resource: this.d.config.resourceUrl.href,
151
+ cookieHash: sha256Hex(cookie),
152
+ starts: 0,
153
+ });
154
+ if (id === null) {
155
+ res.status(503).set(pageHeadersFor([])).set("retry-after", "5").send(errorPage(MSG_BUSY));
156
+ return;
157
+ }
158
+ res.status(200).set(pageHeadersFor(this.formOriginsFor(params.redirectUri))).set("set-cookie", this.cookieHeader(id, cookie)).send(this.signIn(id, client.client_name ?? "Unnamed application", params.redirectUri));
159
+ }
160
+ /**
161
+ * form-action for a page that holds the sign-in form. Browsers apply form-action to every redirect that follows
162
+ * the POST, the last hop included: when the provider skips its consent screen (an account that already approved
163
+ * the app), POST /authorize/start → provider → /authorize/callback → the client's redirect_uri is one form
164
+ * navigation, and without the client's target here the browser blocks the final redirect and the code is lost.
165
+ * null (no form-action at all) for an IPv6-literal callback, which no CSP source can name. That page still has
166
+ * default-src 'none' (no script), escaped values and one form, posting to this server.
167
+ */
168
+ formOriginsFor(redirectUri) {
169
+ const s = formSourceOf(redirectUri);
170
+ if (s === IPV6_LITERAL)
171
+ return null;
172
+ return s !== null && !this.formOrigins.includes(s) ? [...this.formOrigins, s] : this.formOrigins;
173
+ }
174
+ signIn(requestId, clientName, redirectUri, error) {
175
+ return signInPage({
176
+ requestId, clientName, redirectHost: redirectHost(redirectUri), destination: destinationKind(redirectUri), error,
177
+ providers: this.providers.map((p) => ({ name: p, label: PROVIDER_LABEL[p] })),
178
+ privacyUrl: this.d.config.privacyUrl?.href,
179
+ });
180
+ }
181
+ evictExpiredPending() {
182
+ const t = this.d.now();
183
+ for (const [k, v] of this.pending)
184
+ if (t - v.created >= PENDING_TTL_MS)
185
+ this.dropPending(k);
186
+ }
187
+ /** Live sign-in requests held by one client address (expired ones are dropped first when it looks full). */
188
+ livePendingFor(key) {
189
+ if ((this.pendingPerKey.get(key) ?? 0) >= this.maxPendingPerKey)
190
+ this.evictExpiredPending();
191
+ return this.pendingPerKey.get(key) ?? 0;
192
+ }
193
+ /** null when full of LIVE sign-ins: expired ones are evicted, live ones never are (no FIFO eviction). */
194
+ createPending(p) {
195
+ const t = this.d.now();
196
+ if (this.pending.size >= this.maxPending) {
197
+ this.evictExpiredPending();
198
+ if (this.pending.size >= this.maxPending)
199
+ return null;
200
+ }
201
+ const id = randomBytes(32).toString("base64url");
202
+ this.pending.set(id, { ...p, created: t });
203
+ this.pendingPerKey.set(p.key, (this.pendingPerKey.get(p.key) ?? 0) + 1);
204
+ return id;
205
+ }
206
+ dropPending(id) {
207
+ const p = this.pending.get(id);
208
+ if (!p)
209
+ return;
210
+ if (p.upstream)
211
+ this.stateIndex.delete(p.upstream.stateHash);
212
+ this.pending.delete(id);
213
+ const n = (this.pendingPerKey.get(p.key) ?? 1) - 1;
214
+ if (n <= 0)
215
+ this.pendingPerKey.delete(p.key);
216
+ else
217
+ this.pendingPerKey.set(p.key, n);
218
+ }
219
+ getPending(id) {
220
+ const key = str(id, 100);
221
+ if (key === null)
222
+ return null;
223
+ const p = this.pending.get(key);
224
+ if (!p)
225
+ return null;
226
+ if (this.d.now() - p.created >= PENDING_TTL_MS) {
227
+ this.dropPending(key);
228
+ return null;
229
+ }
230
+ return { id: key, p };
231
+ }
232
+ /** Does a live sign-in request with this id exist? (Lets the app spend the global budget only on real requests.) */
233
+ hasPending(id) {
234
+ return this.getPending(id) !== null;
235
+ }
236
+ /** Live request that may still be sent to a provider (the app spends the global budget only for these). */
237
+ canStart(id) {
238
+ const f = this.getPending(id);
239
+ return f !== null && f.p.starts < MAX_STARTS_PER_REQUEST;
240
+ }
241
+ /** Is this upstream state one we issued and have not consumed? */
242
+ hasState(state) {
243
+ const s = str(state, 200);
244
+ return s !== null && this.stateIndex.has(sha256Hex(s));
245
+ }
246
+ cookieMatches(p, cookie) {
247
+ if (!cookie || cookie.length > 200)
248
+ return false;
249
+ const a = Buffer.from(sha256Hex(cookie), "hex");
250
+ const b = Buffer.from(p.cookieHash, "hex");
251
+ return a.length === b.length && timingSafeEqual(a, b);
252
+ }
253
+ dead(status = 400) {
254
+ return page(status, errorPage(MSG_DEAD), []);
255
+ }
256
+ retryPage(p, id, status, error) {
257
+ return page(status, this.signIn(id, p.clientName, p.redirectUri, error), this.formOriginsFor(p.redirectUri));
258
+ }
259
+ // ---- POST /authorize/start ---------------------------------------------
260
+ /** The user chose a provider: bind a fresh upstream state to the pending request and send them there. */
261
+ start(f) {
262
+ const found = this.getPending(f.requestId);
263
+ if (!found)
264
+ return this.dead();
265
+ const { id, p } = found;
266
+ if (!this.cookieMatches(p, this.readCookie(f.cookies, id)))
267
+ return page(400, errorPage(MSG_BROWSER), []);
268
+ if (p.starts >= MAX_STARTS_PER_REQUEST)
269
+ return page(429, errorPage(MSG_TOO_MANY_STARTS), []);
270
+ const provider = this.providers.find((x) => x === f.provider);
271
+ if (!provider)
272
+ return this.retryPage(p, id, 400, "Choose one of the sign-in options below.");
273
+ p.starts++;
274
+ if (p.upstream)
275
+ this.stateIndex.delete(p.upstream.stateHash); // a newer click supersedes the older state
276
+ const state = b64url(randomBytes(32));
277
+ const nonce = b64url(randomBytes(24));
278
+ const pkce = newPkce();
279
+ p.upstream = { stateHash: sha256Hex(state), provider, verifier: pkce.verifier, nonce };
280
+ this.stateIndex.set(p.upstream.stateHash, id);
281
+ return { kind: "redirect", location: this.d.federation.authorizeUrl(provider, { state, challenge: pkce.challenge, nonce }) };
282
+ }
283
+ // ---- GET /authorize/callback/:provider ---------------------------------
284
+ async callback(f) {
285
+ const state = str(f.state, 200);
286
+ const stateHash = state === null ? null : sha256Hex(state);
287
+ const id = stateHash === null ? undefined : this.stateIndex.get(stateHash);
288
+ if (stateHash === null || id === undefined)
289
+ return page(400, errorPage(MSG_STATE), []);
290
+ this.stateIndex.delete(stateHash); // single use, whatever happens next
291
+ const found = this.getPending(id);
292
+ const up = found?.p.upstream;
293
+ if (!found || !up || up.stateHash !== stateHash)
294
+ return this.dead();
295
+ const { p } = found;
296
+ p.upstream = undefined;
297
+ if (!this.cookieMatches(p, this.readCookie(f.cookies, id)))
298
+ return page(400, errorPage(MSG_BROWSER), []);
299
+ if (up.provider !== f.provider)
300
+ return page(400, errorPage(MSG_STATE), []);
301
+ if (f.error !== undefined) {
302
+ // The user declined (or the provider refused): tell the client, exactly as OAuth asks.
303
+ this.dropPending(id);
304
+ const loc = new URL(p.redirectUri);
305
+ loc.searchParams.set("error", "access_denied");
306
+ if (p.state !== undefined)
307
+ loc.searchParams.set("state", p.state);
308
+ return { kind: "redirect", location: loc.href, clearCookieFor: id };
309
+ }
310
+ const code = str(f.code, 2048);
311
+ if (code === null)
312
+ return this.retryPage(p, id, 400, MSG_REJECTED);
313
+ let subject;
314
+ try {
315
+ subject = await this.d.federation.identify(up.provider, code, up.verifier, up.nonce);
316
+ }
317
+ catch (err) {
318
+ if (err instanceof FederationError) {
319
+ this.d.log(`[oauth] ${up.provider}: ${err.message}`);
320
+ return err.kind === "unavailable" ? this.retryPage(p, id, 503, MSG_UNAVAILABLE) : this.retryPage(p, id, 401, MSG_REJECTED);
321
+ }
322
+ throw err; // generic 500 from the app's error handler; nothing sensitive in the message
323
+ }
324
+ // The pending request may have been finished or dropped while we waited on the provider.
325
+ if (this.pending.get(id) !== p)
326
+ return this.dead();
327
+ let uid;
328
+ try {
329
+ const who = resolveIdentity(this.d.dataDir, up.provider, subject);
330
+ if (!who.linked && this.d.config.signup === "invite") {
331
+ // Invite-only: no code, no grant, no tenant for an account the operator has not linked.
332
+ this.dropPending(id);
333
+ const flag = up.provider === "github" ? "--github-id" : "--google-sub";
334
+ this.d.log(`[oauth] sign-in refused (not invited) ${up.provider}=${subject}; invite with: identity link ${flag} ${subject}`);
335
+ return { kind: "page", status: 403, html: errorPage(notInvited(up.provider, subject)), csp: [], clearCookieFor: id };
336
+ }
337
+ uid = who.uid;
338
+ }
339
+ catch (err) {
340
+ this.d.log(`[oauth] identity resolution failed: ${err.message}`);
341
+ if (err instanceof IdentityLinkError) {
342
+ // A misconfigured link: retrying cannot help, so end the request instead of offering "try again".
343
+ this.dropPending(id);
344
+ return { kind: "page", status: 403, html: errorPage(MSG_LINK), csp: [], clearCookieFor: id };
345
+ }
346
+ return this.retryPage(p, id, 503, MSG_UNAVAILABLE);
347
+ }
348
+ this.dropPending(id);
349
+ try {
350
+ this.d.onSignIn?.(uid);
351
+ }
352
+ catch { /* a counter never fails a sign-in */ }
353
+ return { kind: "redirect", location: this.issueCode(p, uid, up.provider, subject), clearCookieFor: id };
354
+ }
355
+ issueCode(p, uid, provider, subject) {
356
+ const t = this.d.now();
357
+ if (this.codes.size >= MAX_CODES) {
358
+ for (const [k, v] of this.codes)
359
+ if (v.exp <= t)
360
+ this.codes.delete(k);
361
+ while (this.codes.size >= MAX_CODES)
362
+ this.codes.delete(this.codes.keys().next().value);
363
+ }
364
+ const code = randomBytes(32).toString("base64url");
365
+ this.codes.set(sha256Hex(code), {
366
+ clientId: p.clientId, redirectUri: p.redirectUri, codeChallenge: p.codeChallenge,
367
+ resource: p.resource, uid, exp: t + CODE_TTL_MS, lookups: 0,
368
+ });
369
+ const key = `${provider}:${subject}`;
370
+ if (!this.loggedSubjects.has(key) && !this.d.store.hasGrantForUid(uid)) {
371
+ if (this.loggedSubjects.size >= MAX_LOGGED_SUBJECTS)
372
+ this.loggedSubjects.clear();
373
+ this.loggedSubjects.add(key);
374
+ this.d.log(`oauth login ${provider}=${subject} uid=${uid}`);
375
+ }
376
+ const loc = new URL(p.redirectUri);
377
+ loc.searchParams.set("code", code);
378
+ if (p.state !== undefined)
379
+ loc.searchParams.set("state", p.state);
380
+ return loc.href;
381
+ }
382
+ // ---- /token ------------------------------------------------------------
383
+ async challengeForAuthorizationCode(client, authorizationCode) {
384
+ const key = sha256Hex(authorizationCode);
385
+ const rec = this.codes.get(key);
386
+ if (!rec || rec.exp <= this.d.now() || rec.clientId !== client.client_id) {
387
+ if (rec && rec.exp <= this.d.now())
388
+ this.codes.delete(key);
389
+ throw new InvalidGrantError("authorization code is invalid, expired or already used");
390
+ }
391
+ // The SDK verifies the PKCE verifier after this call and cannot tell us the result: bound the guesses.
392
+ if (++rec.lookups > MAX_CHALLENGE_LOOKUPS) {
393
+ this.codes.delete(key);
394
+ throw new InvalidGrantError("authorization code is invalid, expired or already used");
395
+ }
396
+ return rec.codeChallenge;
397
+ }
398
+ async exchangeAuthorizationCode(client, authorizationCode, _codeVerifier, redirectUri, resource) {
399
+ const key = sha256Hex(authorizationCode);
400
+ const rec = this.codes.get(key);
401
+ this.codes.delete(key); // single use, whatever happens next
402
+ if (!rec || rec.exp <= this.d.now() || rec.clientId !== client.client_id) {
403
+ throw new InvalidGrantError("authorization code is invalid, expired or already used");
404
+ }
405
+ if (redirectUri !== undefined && redirectUri !== rec.redirectUri)
406
+ throw new InvalidGrantError("redirect_uri does not match the authorization request");
407
+ if (resource && resource.href !== rec.resource)
408
+ throw new InvalidTargetError(`resource must be ${rec.resource}`);
409
+ const tokens = this.d.store.createGrant({ uid: rec.uid, clientId: client.client_id, resource: rec.resource });
410
+ this.d.store.touchClient(client.client_id);
411
+ return toOAuthTokens(tokens);
412
+ }
413
+ async exchangeRefreshToken(client, refreshToken, _scopes, resource) {
414
+ if (resource && resource.href !== this.d.config.resourceUrl.href) {
415
+ throw new InvalidTargetError(`resource must be ${this.d.config.resourceUrl.href}`);
416
+ }
417
+ const r = this.d.store.rotateRefresh(client.client_id, refreshToken);
418
+ if (r.type === "reuse") {
419
+ this.d.log(`[oauth] refresh token reuse detected, grant ${r.grantId} revoked`);
420
+ throw new InvalidGrantError("refresh token was already used; the grant has been revoked, sign in again");
421
+ }
422
+ if (r.type !== "ok")
423
+ throw new InvalidGrantError("refresh token is invalid, expired or revoked");
424
+ this.d.store.touchClient(client.client_id);
425
+ return toOAuthTokens(r.tokens);
426
+ }
427
+ async revokeToken(client, request) {
428
+ this.d.store.revokeToken(client.client_id, request.token);
429
+ }
430
+ // ---- resource side -----------------------------------------------------
431
+ async verifyAccessToken(token) {
432
+ const r = this.d.store.resolveAccess(token);
433
+ if (!r || r.resource !== this.d.config.resourceUrl.href)
434
+ throw new InvalidTokenError("invalid or expired access token");
435
+ return {
436
+ token, clientId: r.clientId, scopes: [OAUTH_SCOPE], expiresAt: Math.floor(r.expiresAt / 1000),
437
+ resource: this.d.config.resourceUrl, extra: { uid: r.uid },
438
+ };
439
+ }
440
+ }
441
+ function toOAuthTokens(t) {
442
+ return { access_token: t.access_token, token_type: "Bearer", expires_in: t.expires_in, refresh_token: t.refresh_token, scope: OAUTH_SCOPE };
443
+ }
444
+ function page(status, html, csp) {
445
+ return { kind: "page", status, html, csp };
446
+ }
447
+ /** Where the result goes: a program on this computer, claude.ai/claude.com, or anything else the operator allowed. */
448
+ function destinationKind(redirectUri) {
449
+ try {
450
+ const u = new URL(redirectUri);
451
+ if (u.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(u.hostname))
452
+ return "loopback";
453
+ if (u.protocol === "https:" && (u.hostname === "claude.ai" || u.hostname === "claude.com"))
454
+ return "claude";
455
+ }
456
+ catch { /* fall through */ }
457
+ return "other";
458
+ }
459
+ const IPV6_LITERAL = Symbol("ipv6-literal");
460
+ /**
461
+ * CSP source for a redirect target: its origin for http(s), its scheme (`cursor:`) for a custom-scheme callback,
462
+ * IPV6_LITERAL for an IPv6-literal host (CSP host-source has no IP-literal form), null when it has none.
463
+ */
464
+ function formSourceOf(redirectUri) {
465
+ try {
466
+ const u = new URL(redirectUri);
467
+ if ((u.protocol === "http:" || u.protocol === "https:") && u.hostname.startsWith("["))
468
+ return IPV6_LITERAL;
469
+ if (u.protocol === "http:" || u.protocol === "https:")
470
+ return u.origin;
471
+ return isCustomSchemeSource(u.protocol) ? u.protocol : null;
472
+ }
473
+ catch {
474
+ return null;
475
+ }
476
+ }
477
+ function redirectHost(redirectUri) {
478
+ try {
479
+ const u = new URL(redirectUri);
480
+ return u.host || `${u.protocol}//`;
481
+ }
482
+ catch {
483
+ return "(unknown)";
484
+ }
485
+ }
486
+ //# sourceMappingURL=oauth-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-provider.js","sourceRoot":"","sources":["../../src/http/oauth-provider.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK3D,OAAO,EACL,gBAAgB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,mBAAmB,EACpF,kBAAkB,EAAE,iBAAiB,GACtC,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAc,SAAS,EAAwC,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAc,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE9G,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,mHAAmH;AACnH,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,MAAM,QAAQ,GAAG,gHAAgH,CAAC;AAClI,MAAM,WAAW,GAAG,uGAAuG,CAAC;AAC5H,MAAM,SAAS,GAAG,0HAA0H,CAAC;AAC7I,MAAM,QAAQ,GAAG,uEAAuE,CAAC;AACzF,MAAM,mBAAmB,GAAG,kFAAkF,CAAC;AAC/G,MAAM,YAAY,GAAG,2DAA2D,CAAC;AACjF,MAAM,eAAe,GAAG,wEAAwE,CAAC;AACjG,MAAM,QAAQ,GAAG,4HAA4H,CAAC;AAC9I,MAAM,WAAW,GAAG,mHAAmH,CAAC;AACxI,MAAM,UAAU,GAAG,CAAC,QAAsB,EAAE,OAAe,EAAU,EAAE,CACrE,QAAQ,cAAc,CAAC,QAAQ,CAAC,sDAAsD;IACtF,uDAAuD,QAAQ,IAAI,OAAO,EAAE,CAAC;AAyD/E,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,GAAW,EAAiB,EAAE,CACrD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAEtE,MAAM,OAAO,sBAAsB;IAaJ;IAZpB,YAAY,CAA8B;IAClC,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,gBAAgB,CAAS;IACzB,SAAS,CAAiB;IAC1B,UAAU,CAAS;IACpC,8FAA8F;IACrF,WAAW,CAAW;IAE/B,YAA6B,CAAe;QAAf,MAAC,GAAD,CAAC,CAAc;QAC1C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,mBAAmB,CAAC;QACtD,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,IAAI,2BAA2B,CAAC;QAC1E,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,YAAY,GAAG;YAClB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,2GAA2G;IACnG,aAAa,CAAC,EAAU;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9G,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACvE,CAAC;IAED,qGAAqG;IACrG,UAAU,CAAC,SAAiB;QAC1B,OAAO,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEO,UAAU,CAAC,MAA0B,EAAE,SAAiB;QAC9D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sFAAsF;IACtF,YAAY,CAAC,SAAiB,EAAE,KAAoB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,EAAE,sDAAsD,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IACjK,CAAC;IAED,2EAA2E;IAEnE,cAAc,CAAC,IAA2E;QAChG,MAAM,IAAI,GAAI,IAAoC,CAAC,aAAa,CAAC;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;YACjF,MAAM,IAAI,0BAA0B,CAAC,6BAA6B,iBAAiB,OAAO,CAAC,CAAC;QAC9F,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;gBAC/D,MAAM,IAAI,0BAA0B,CAAC,4BAA4B,sBAAsB,aAAa,CAAC,CAAC;YACxG,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC/D,MAAM,IAAI,gBAAgB,CAAC,sBAAsB,EAAE,uGAAuG,CAAC,CAAC;YAC9J,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,4CAA4C;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,IAAI,qBAAqB,CAAC;QACtL,kGAAkG;QAClG,MAAM,MAAM,GAAiB;YAC3B,SAAS,EAAG,IAA+B,CAAC,SAAS,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxF,mBAAmB,EAAG,IAAyC,CAAC,mBAAmB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YACtH,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAC/B,WAAW,EAAE,IAAI;YACjB,0BAA0B,EAAE,MAAM;YAClC,WAAW,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;YACpD,cAAc,EAAE,CAAC,MAAM,CAAC;YACxB,KAAK,EAAE,WAAW;SACnB,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;QACtD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,SAAS,CAAC,MAAkC,EAAE,MAA2B,EAAE,GAAa;QAC5F,uEAAuE;QACvE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,4CAA4C,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC/G,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC/E,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;YAC/E,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,sBAAsB,aAAa,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,mBAAmB,CAAC,8CAA8C,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;YAC9F,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;YAC5B,GAAG;YACH,QAAQ,EAAE,MAAM,CAAC,SAAS;YAC1B,UAAU,EAAE,MAAM,CAAC,WAAW,IAAI,qBAAqB;YACvD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI;YACxC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC;YAC7B,MAAM,EAAE,CAAC;SACV,CAAC,CAAC;QACH,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,IAAI,qBAAqB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACvN,CAAC;IAED;;;;;;;OAOG;IACK,cAAc,CAAC,WAAmB;QACxC,MAAM,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IACnG,CAAC;IAEO,MAAM,CAAC,SAAiB,EAAE,UAAkB,EAAE,WAAmB,EAAE,KAAc;QACvF,OAAO,UAAU,CAAC;YAChB,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,KAAK;YAChH,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7E,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI;SAC3C,CAAC,CAAC;IACL,CAAC;IAEO,mBAAmB;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,cAAc;gBAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,4GAA4G;IACpG,cAAc,CAAC,GAAW;QAChC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB;YAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC5F,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,yGAAyG;IACjG,aAAa,CAAC,CAAwC;QAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;QACxD,CAAC;QACD,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,WAAW,CAAC,EAAU;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,IAAI,CAAC,CAAC,QAAQ;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;;YACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAEO,UAAU,CAAC,EAAW;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzB,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,oHAAoH;IACpH,UAAU,CAAC,EAAW;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACtC,CAAC;IAED,2GAA2G;IAC3G,QAAQ,CAAC,EAAW;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,sBAAsB,CAAC;IAC3D,CAAC;IAED,kEAAkE;IAClE,QAAQ,CAAC,KAAc;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAEO,aAAa,CAAC,CAAU,EAAE,MAA0B;QAC1D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;QACjD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAEO,IAAI,CAAC,MAAM,GAAG,GAAG;QACvB,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,SAAS,CAAC,CAAU,EAAE,EAAU,EAAE,MAAc,EAAE,KAAa;QACrE,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/G,CAAC;IAED,2EAA2E;IAE3E,yGAAyG;IACzG,KAAK,CAAC,CAAyE;QAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QACzG,IAAI,CAAC,CAAC,MAAM,IAAI,sBAAsB;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,0CAA0C,CAAC,CAAC;QAC7F,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,IAAI,CAAC,CAAC,QAAQ;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,2CAA2C;QACzG,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,CAAC,CAAC,QAAQ,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QACvF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC/H,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,QAAQ,CAAC,CAAmG;QAChH,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3E,IAAI,SAAS,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,oCAAoC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC;QACpB,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QACzG,IAAI,EAAE,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAE3E,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1B,uFAAuF;YACvF,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC/C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QACnE,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrD,OAAO,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;YAC7H,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,6EAA6E;QAC1F,CAAC;QACD,yFAAyF;QACzF,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClE,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrD,wFAAwF;gBACxF,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACrB,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;gBACvE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,yCAAyC,EAAE,CAAC,QAAQ,IAAI,OAAO,gCAAgC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;gBAC7H,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;YACvH,CAAC;YACD,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,uCAAwC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;gBACrC,kGAAkG;gBAClG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;YAC/F,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC;YAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IAC1G,CAAC;IAEO,SAAS,CAAC,CAAU,EAAE,GAAW,EAAE,QAAsB,EAAE,OAAe;QAChF,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;oBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa;YAChF,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC;SAC5D,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACvE,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,mBAAmB;gBAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;YACjF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,QAAQ,IAAI,OAAO,QAAQ,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,6BAA6B,CAAC,MAAkC,EAAE,iBAAyB;QAC/F,MAAM,GAAG,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACzE,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,IAAI,iBAAiB,CAAC,wDAAwD,CAAC,CAAC;QACxF,CAAC;QACD,uGAAuG;QACvG,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,qBAAqB,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,IAAI,iBAAiB,CAAC,wDAAwD,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,MAAkC,EAAE,iBAAyB,EAAE,aAAsB,EAAE,WAAoB,EAAE,QAAc;QAE3H,MAAM,GAAG,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC;QAC5D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACzE,MAAM,IAAI,iBAAiB,CAAC,wDAAwD,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,GAAG,CAAC,WAAW;YAAE,MAAM,IAAI,iBAAiB,CAAC,uDAAuD,CAAC,CAAC;QACvJ,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,QAAQ;YAAE,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjH,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9G,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,MAAkC,EAAE,YAAoB,EAAE,OAAkB,EAAE,QAAc;QACrH,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACjE,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC;YAC/E,MAAM,IAAI,iBAAiB,CAAC,2EAA2E,CAAC,CAAC;QAC3G,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;YAAE,MAAM,IAAI,iBAAiB,CAAC,8CAA8C,CAAC,CAAC;QACjG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAkC,EAAE,OAAoC;QACxF,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,iBAAiB,CAAC,KAAa;QACnC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI;YAAE,MAAM,IAAI,iBAAiB,CAAC,iCAAiC,CAAC,CAAC;QACxH,OAAO;YACL,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;YAC7F,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,SAAS,aAAa,CAAC,CAAe;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC9I,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,IAAY,EAAE,GAAoB;IAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC7C,CAAC;AAED,sHAAsH;AACtH,SAAS,eAAe,CAAC,WAAmB;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,OAAO,UAAU,CAAC;QAC1G,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC9G,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5C;;;GAGG;AACH,SAAS,YAAY,CAAC,WAAmB;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;QAC3G,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC;QACvE,OAAO,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,WAAmB;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC"}
@@ -0,0 +1,128 @@
1
+ import type { OAuthClientInformationFull } from "@modelcontextprotocol/sdk/shared/auth.js";
2
+ export declare const ACCESS_TTL_MS: number;
3
+ export declare const REFRESH_TTL_MS: number;
4
+ export declare const MAX_CLIENTS = 5000;
5
+ /** A grant dies this long after sign-in no matter how often it is refreshed. */
6
+ export declare const ABSOLUTE_GRANT_TTL_MS: number;
7
+ /** Live grants per uid (one per signed-in client/device); a new sign-in evicts the oldest beyond this. */
8
+ export declare const MAX_GRANTS_PER_UID = 20;
9
+ /** The just-rotated refresh token still works this long, for the same client only. */
10
+ export declare const REFRESH_GRACE_MS: number;
11
+ export declare function sha256Hex(s: string): string;
12
+ export interface StoredClient extends OAuthClientInformationFull {
13
+ /** ms epoch of the last token exchange; undefined = never used (pruned first). */
14
+ last_used_at?: number;
15
+ }
16
+ export interface Grant {
17
+ id: string;
18
+ uid: string;
19
+ client_id: string;
20
+ resource: string;
21
+ created_at: string;
22
+ revoked_at?: string;
23
+ access: Array<{
24
+ hash: string;
25
+ exp: number;
26
+ }>;
27
+ refresh: {
28
+ hash: string;
29
+ exp: number;
30
+ };
31
+ rotated: string[];
32
+ /** The refresh token rotated last, still accepted from the same client until `until` (ms epoch). */
33
+ grace?: {
34
+ hash: string;
35
+ until: number;
36
+ };
37
+ }
38
+ export type JsonWriter = (filePath: string, data: unknown) => void;
39
+ export interface RevokedFile {
40
+ version: 1;
41
+ grants: Record<string, string>;
42
+ uids: Record<string, string>;
43
+ }
44
+ export declare const parseRevoked: (raw: unknown) => RevokedFile | null;
45
+ export declare const emptyRevoked: () => RevokedFile;
46
+ export declare const revokedPath: (dataDir: string) => string;
47
+ export declare function readGrantsFresh(dataDir: string): Grant[];
48
+ export declare function operatorRevokeGrant(dataDir: string, grantId: string): boolean;
49
+ export declare function readJsonFreshRevoked(dataDir: string): RevokedFile;
50
+ /** Revokes every grant of `uid` created up to now; sign-ins afterwards work normally. */
51
+ export declare function operatorRevokeUid(dataDir: string, uid: string): void;
52
+ export interface IssuedTokens {
53
+ access_token: string;
54
+ refresh_token: string;
55
+ expires_in: number;
56
+ }
57
+ export type RefreshResult = {
58
+ type: "ok";
59
+ tokens: IssuedTokens;
60
+ grant: Grant;
61
+ } | {
62
+ type: "invalid";
63
+ } | {
64
+ type: "reuse";
65
+ grantId: string;
66
+ };
67
+ export declare class OAuthStore {
68
+ private readonly dataDir;
69
+ private readonly now;
70
+ /** Test seam: the file writer (default atomic tmp + rename). */
71
+ private readonly write;
72
+ private clients;
73
+ private grants;
74
+ private byAccess;
75
+ private byRefresh;
76
+ private byRotated;
77
+ private readonly clientsPath;
78
+ private readonly grantsPath;
79
+ constructor(dataDir: string, now?: () => number,
80
+ /** Test seam: the file writer (default atomic tmp + rename). */
81
+ write?: JsonWriter);
82
+ getClient(id: string): StoredClient | undefined;
83
+ addClient(client: StoredClient): void;
84
+ touchClient(id: string): void;
85
+ clientCount(): number;
86
+ /** Write, then swap: a failed write leaves the in-memory clients as on disk. */
87
+ private commitClients;
88
+ private reindex;
89
+ /**
90
+ * Prune `next` (expired grants, old revoked ones, expired access tokens) WITHOUT touching
91
+ * any grant object that is live in memory, write it, and only then make it current.
92
+ */
93
+ private commitGrants;
94
+ private replaceGrant;
95
+ private newAccess;
96
+ hasGrantForUid(uid: string): boolean;
97
+ createGrant(p: {
98
+ uid: string;
99
+ clientId: string;
100
+ resource: string;
101
+ }): IssuedTokens;
102
+ /** Operator revocations, re-read (mtime-cached) on every check so the CLI takes effect at once. */
103
+ private operatorRevoked;
104
+ private live;
105
+ /** Access token → uid/client/resource, or null (unknown, expired, revoked, wrong audience). */
106
+ resolveAccess(token: string): {
107
+ uid: string;
108
+ grantId: string;
109
+ clientId: string;
110
+ resource: string;
111
+ expiresAt: number;
112
+ } | null;
113
+ /** The live (not revoked, not expired) grants of `uid`, newest first, for the owner's connections list. Never includes token material. */
114
+ liveGrantsOf(uid: string): Array<{
115
+ id: string;
116
+ clientName: string;
117
+ createdAt: string;
118
+ lastUsedAt?: string;
119
+ }>;
120
+ /** The owner disconnects one of THEIR grants. A grant id that does not exist or belongs to another uid changes nothing. */
121
+ revokeGrantOf(uid: string, grantId: string): boolean;
122
+ /** Issue a new refresh + access token for `g`. `grace` = whether this rotation starts a new grace window. */
123
+ private rotate;
124
+ rotateRefresh(clientId: string, refreshToken: string): RefreshResult;
125
+ /** RFC 7009: unknown/foreign tokens are ignored silently. Refresh token → whole grant; access token → that token. */
126
+ revokeToken(clientId: string, token: string): void;
127
+ }
128
+ //# sourceMappingURL=oauth-store.d.ts.map