@blen/uspto-mcp-server 0.0.0-stage → 0.1.2

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 (201) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +55 -0
  4. package/README.md +229 -2
  5. package/SECURITY.md +142 -0
  6. package/dist/accounts/app.d.ts +18 -0
  7. package/dist/accounts/app.d.ts.map +1 -0
  8. package/dist/accounts/app.js +407 -0
  9. package/dist/accounts/app.js.map +1 -0
  10. package/dist/accounts/config.d.ts +21 -0
  11. package/dist/accounts/config.d.ts.map +1 -0
  12. package/dist/accounts/config.js +55 -0
  13. package/dist/accounts/config.js.map +1 -0
  14. package/dist/accounts/crypto.d.ts +18 -0
  15. package/dist/accounts/crypto.d.ts.map +1 -0
  16. package/dist/accounts/crypto.js +43 -0
  17. package/dist/accounts/crypto.js.map +1 -0
  18. package/dist/accounts/keyGates.d.ts +19 -0
  19. package/dist/accounts/keyGates.d.ts.map +1 -0
  20. package/dist/accounts/keyGates.js +47 -0
  21. package/dist/accounts/keyGates.js.map +1 -0
  22. package/dist/accounts/paths.d.ts +10 -0
  23. package/dist/accounts/paths.d.ts.map +1 -0
  24. package/dist/accounts/paths.js +10 -0
  25. package/dist/accounts/paths.js.map +1 -0
  26. package/dist/accounts/portal.d.ts +7 -0
  27. package/dist/accounts/portal.d.ts.map +1 -0
  28. package/dist/accounts/portal.js +225 -0
  29. package/dist/accounts/portal.js.map +1 -0
  30. package/dist/accounts/provider.d.ts +2610 -0
  31. package/dist/accounts/provider.d.ts.map +1 -0
  32. package/dist/accounts/provider.js +108 -0
  33. package/dist/accounts/provider.js.map +1 -0
  34. package/dist/accounts/runtime.d.ts +26 -0
  35. package/dist/accounts/runtime.d.ts.map +1 -0
  36. package/dist/accounts/runtime.js +168 -0
  37. package/dist/accounts/runtime.js.map +1 -0
  38. package/dist/accounts/store.d.ts +30 -0
  39. package/dist/accounts/store.d.ts.map +1 -0
  40. package/dist/accounts/store.js +155 -0
  41. package/dist/accounts/store.js.map +1 -0
  42. package/dist/bin.d.ts +3 -0
  43. package/dist/bin.d.ts.map +1 -0
  44. package/dist/bin.js +195 -0
  45. package/dist/bin.js.map +1 -0
  46. package/dist/index.d.ts +11 -0
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +8 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/sandbox/deno.d.ts +35 -0
  51. package/dist/sandbox/deno.d.ts.map +1 -0
  52. package/dist/sandbox/deno.js +373 -0
  53. package/dist/sandbox/deno.js.map +1 -0
  54. package/dist/sandbox/index.d.ts +28 -0
  55. package/dist/sandbox/index.d.ts.map +1 -0
  56. package/dist/sandbox/index.js +55 -0
  57. package/dist/sandbox/index.js.map +1 -0
  58. package/dist/sandbox/isolate.d.ts +17 -0
  59. package/dist/sandbox/isolate.d.ts.map +1 -0
  60. package/dist/sandbox/isolate.js +195 -0
  61. package/dist/sandbox/isolate.js.map +1 -0
  62. package/dist/sandbox/limits.d.ts +60 -0
  63. package/dist/sandbox/limits.d.ts.map +1 -0
  64. package/dist/sandbox/limits.js +86 -0
  65. package/dist/sandbox/limits.js.map +1 -0
  66. package/dist/sandbox/policy.d.ts +7 -0
  67. package/dist/sandbox/policy.d.ts.map +1 -0
  68. package/dist/sandbox/policy.js +87 -0
  69. package/dist/sandbox/policy.js.map +1 -0
  70. package/dist/sandbox/types.d.ts +57 -0
  71. package/dist/sandbox/types.d.ts.map +1 -0
  72. package/dist/sandbox/types.js +6 -0
  73. package/dist/sandbox/types.js.map +1 -0
  74. package/dist/sdk/bindings.d.ts +13 -0
  75. package/dist/sdk/bindings.d.ts.map +1 -0
  76. package/dist/sdk/bindings.js +22 -0
  77. package/dist/sdk/bindings.js.map +1 -0
  78. package/dist/sdk/odp-client.d.ts +167 -0
  79. package/dist/sdk/odp-client.d.ts.map +1 -0
  80. package/dist/sdk/odp-client.js +253 -0
  81. package/dist/sdk/odp-client.js.map +1 -0
  82. package/dist/sdk/runtime.d.ts +21 -0
  83. package/dist/sdk/runtime.d.ts.map +1 -0
  84. package/dist/sdk/runtime.js +32 -0
  85. package/dist/sdk/runtime.js.map +1 -0
  86. package/dist/sdk/sources/corpus-loader.d.ts +8 -0
  87. package/dist/sdk/sources/corpus-loader.d.ts.map +1 -0
  88. package/dist/sdk/sources/corpus-loader.js +17 -0
  89. package/dist/sdk/sources/corpus-loader.js.map +1 -0
  90. package/dist/sdk/sources/index.d.ts +8 -0
  91. package/dist/sdk/sources/index.d.ts.map +1 -0
  92. package/dist/sdk/sources/index.js +25 -0
  93. package/dist/sdk/sources/index.js.map +1 -0
  94. package/dist/sdk/sources/odp.d.ts +5 -0
  95. package/dist/sdk/sources/odp.d.ts.map +1 -0
  96. package/dist/sdk/sources/odp.js +78 -0
  97. package/dist/sdk/sources/odp.js.map +1 -0
  98. package/dist/sdk/sources/source.d.ts +44 -0
  99. package/dist/sdk/sources/source.d.ts.map +1 -0
  100. package/dist/sdk/sources/source.js +3 -0
  101. package/dist/sdk/sources/source.js.map +1 -0
  102. package/dist/sdk/sources/tsdr.d.ts +5 -0
  103. package/dist/sdk/sources/tsdr.d.ts.map +1 -0
  104. package/dist/sdk/sources/tsdr.js +38 -0
  105. package/dist/sdk/sources/tsdr.js.map +1 -0
  106. package/dist/sdk/tsdr-client.d.ts +24 -0
  107. package/dist/sdk/tsdr-client.d.ts.map +1 -0
  108. package/dist/sdk/tsdr-client.js +65 -0
  109. package/dist/sdk/tsdr-client.js.map +1 -0
  110. package/dist/search/bm25.d.ts +25 -0
  111. package/dist/search/bm25.d.ts.map +1 -0
  112. package/dist/search/bm25.js +67 -0
  113. package/dist/search/bm25.js.map +1 -0
  114. package/dist/search/corpus.d.ts +24 -0
  115. package/dist/search/corpus.d.ts.map +1 -0
  116. package/dist/search/corpus.js +23 -0
  117. package/dist/search/corpus.js.map +1 -0
  118. package/dist/server/authz.d.ts +40 -0
  119. package/dist/server/authz.d.ts.map +1 -0
  120. package/dist/server/authz.js +70 -0
  121. package/dist/server/authz.js.map +1 -0
  122. package/dist/server/http.d.ts +44 -0
  123. package/dist/server/http.d.ts.map +1 -0
  124. package/dist/server/http.js +199 -0
  125. package/dist/server/http.js.map +1 -0
  126. package/dist/server/ipRateLimiter.d.ts +22 -0
  127. package/dist/server/ipRateLimiter.d.ts.map +1 -0
  128. package/dist/server/ipRateLimiter.js +58 -0
  129. package/dist/server/ipRateLimiter.js.map +1 -0
  130. package/dist/server/mcpServer.d.ts +22 -0
  131. package/dist/server/mcpServer.d.ts.map +1 -0
  132. package/dist/server/mcpServer.js +90 -0
  133. package/dist/server/mcpServer.js.map +1 -0
  134. package/dist/server/stdio.d.ts +3 -0
  135. package/dist/server/stdio.d.ts.map +1 -0
  136. package/dist/server/stdio.js +16 -0
  137. package/dist/server/stdio.js.map +1 -0
  138. package/dist/server/toolCatalog.d.ts +162 -0
  139. package/dist/server/toolCatalog.d.ts.map +1 -0
  140. package/dist/server/toolCatalog.js +83 -0
  141. package/dist/server/toolCatalog.js.map +1 -0
  142. package/dist/server/wellKnown.d.ts +16 -0
  143. package/dist/server/wellKnown.d.ts.map +1 -0
  144. package/dist/server/wellKnown.js +17 -0
  145. package/dist/server/wellKnown.js.map +1 -0
  146. package/dist/server/zodToJsonSchema.d.ts +8 -0
  147. package/dist/server/zodToJsonSchema.d.ts.map +1 -0
  148. package/dist/server/zodToJsonSchema.js +14 -0
  149. package/dist/server/zodToJsonSchema.js.map +1 -0
  150. package/dist/supervisor/index.d.ts +54 -0
  151. package/dist/supervisor/index.d.ts.map +1 -0
  152. package/dist/supervisor/index.js +62 -0
  153. package/dist/supervisor/index.js.map +1 -0
  154. package/dist/tools/describeSchema.d.ts +23 -0
  155. package/dist/tools/describeSchema.d.ts.map +1 -0
  156. package/dist/tools/describeSchema.js +14 -0
  157. package/dist/tools/describeSchema.js.map +1 -0
  158. package/dist/tools/execute.d.ts +36 -0
  159. package/dist/tools/execute.d.ts.map +1 -0
  160. package/dist/tools/execute.js +70 -0
  161. package/dist/tools/execute.js.map +1 -0
  162. package/dist/tools/searchApi.d.ts +21 -0
  163. package/dist/tools/searchApi.d.ts.map +1 -0
  164. package/dist/tools/searchApi.js +14 -0
  165. package/dist/tools/searchApi.js.map +1 -0
  166. package/dist/util/executionContext.d.ts +6 -0
  167. package/dist/util/executionContext.d.ts.map +1 -0
  168. package/dist/util/executionContext.js +26 -0
  169. package/dist/util/executionContext.js.map +1 -0
  170. package/dist/util/executionLimiter.d.ts +19 -0
  171. package/dist/util/executionLimiter.d.ts.map +1 -0
  172. package/dist/util/executionLimiter.js +41 -0
  173. package/dist/util/executionLimiter.js.map +1 -0
  174. package/dist/util/httpClient.d.ts +116 -0
  175. package/dist/util/httpClient.d.ts.map +1 -0
  176. package/dist/util/httpClient.js +434 -0
  177. package/dist/util/httpClient.js.map +1 -0
  178. package/dist/util/logger.d.ts +7 -0
  179. package/dist/util/logger.d.ts.map +1 -0
  180. package/dist/util/logger.js +25 -0
  181. package/dist/util/logger.js.map +1 -0
  182. package/dist/util/quotas.d.ts +13 -0
  183. package/dist/util/quotas.d.ts.map +1 -0
  184. package/dist/util/quotas.js +29 -0
  185. package/dist/util/quotas.js.map +1 -0
  186. package/dist/util/tokenBucket.d.ts +11 -0
  187. package/dist/util/tokenBucket.d.ts.map +1 -0
  188. package/dist/util/tokenBucket.js +30 -0
  189. package/dist/util/tokenBucket.js.map +1 -0
  190. package/dist/util/upstreamGate.d.ts +36 -0
  191. package/dist/util/upstreamGate.d.ts.map +1 -0
  192. package/dist/util/upstreamGate.js +112 -0
  193. package/dist/util/upstreamGate.js.map +1 -0
  194. package/dist/web/THIRD_PARTY_NOTICES.txt +1940 -0
  195. package/dist/web/assets/blen-logo-BKJFojyj.png +0 -0
  196. package/dist/web/assets/index-Dbbu8lq3.js +317 -0
  197. package/dist/web/assets/index-DkKvyv-b.css +2 -0
  198. package/dist/web/index.html +14 -0
  199. package/package.json +127 -4
  200. package/schema/odp.json +743 -0
  201. package/schema/tsdr.json +129 -0
@@ -0,0 +1,434 @@
1
+ import { request } from 'undici';
2
+ import { LRUCache } from 'lru-cache';
3
+ import { createHash } from 'node:crypto';
4
+ import { gunzip } from 'node:zlib';
5
+ import { promisify } from 'node:util';
6
+ import { log } from './logger.js';
7
+ import { abortError, currentSignal, sleep } from './executionContext.js';
8
+ const decompressGzip = promisify(gunzip);
9
+ /**
10
+ * Upper bound on an upstream's Retry-After when pausing every caller of that upstream: the full
11
+ * not-before time is honored (a weekly quota resets up to 7 days later); this only guards against
12
+ * absurd values.
13
+ */
14
+ const MAX_GATE_PAUSE_MS = 8 * 24 * 60 * 60 * 1000;
15
+ /** Longest a single call sleeps before its one 429 retry; longer cooldowns fail the call instead. */
16
+ const MAX_RETRY_WAIT_MS = 30_000;
17
+ /** Largest upstream response body kept in memory (after decompression), by default. */
18
+ export const DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
19
+ export class HttpClient {
20
+ #defaultHeaders;
21
+ cache;
22
+ cacheEnabled;
23
+ baseUrl;
24
+ userAgent;
25
+ timeoutMs;
26
+ retries;
27
+ retry429;
28
+ min429PauseMs;
29
+ maxResponseBytes;
30
+ dispatcher;
31
+ preflightLimiter;
32
+ gate;
33
+ label;
34
+ /**
35
+ * Identical requests already on the wire; later callers share the first one's result. The shared
36
+ * request is aborted only when every caller waiting on it has aborted.
37
+ */
38
+ inflight = new Map();
39
+ /** Credential values from defaultHeaders, scrubbed from every upstream body and error. */
40
+ #secrets;
41
+ constructor(opts) {
42
+ this.#defaultHeaders = opts.defaultHeaders ?? {};
43
+ this.#secrets = Object.values(this.#defaultHeaders).filter(v => typeof v === 'string' && v.length >= 8);
44
+ this.baseUrl = opts.baseUrl;
45
+ this.userAgent = opts.userAgent ?? 'uspto-mcp-server/1.0 (+https://github.com/blen-labs/uspto-mcp-server)';
46
+ this.timeoutMs = opts.timeoutMs ?? 30_000;
47
+ this.retries = opts.retries ?? 3;
48
+ this.retry429 = opts.retry429 ?? true;
49
+ this.min429PauseMs = opts.min429PauseMs ?? 0;
50
+ this.maxResponseBytes = opts.maxResponseBytes ?? DEFAULT_MAX_RESPONSE_BYTES;
51
+ this.dispatcher = opts.dispatcher;
52
+ this.preflightLimiter = opts.preflightLimiter;
53
+ this.gate = opts.gate;
54
+ this.label = opts.label ?? new URL(opts.baseUrl).host;
55
+ const max = opts.cacheMaxItems ?? 2000;
56
+ const ttl = opts.cacheTtlMs ?? 300_000;
57
+ this.cacheEnabled = max > 0 && ttl > 0;
58
+ const maxBytes = Math.max(opts.cacheMaxBytes ?? 32 * 1024 * 1024, 1024);
59
+ this.cache = new LRUCache({
60
+ max: Math.max(max, 1), ttl: Math.max(ttl, 1),
61
+ // A response bigger than the whole cache is simply not cached.
62
+ maxSize: maxBytes, maxEntrySize: maxBytes, sizeCalculation: v => Math.max(1, v.size),
63
+ });
64
+ }
65
+ async call(o) {
66
+ if (o.body !== undefined && o.form !== undefined)
67
+ throw new TypeError('Pass either body or form, not both');
68
+ const url = this.buildUrl(o.path, o.query);
69
+ const method = o.method ?? 'GET';
70
+ const payload = o.form !== undefined ? encodeForm(o.form) : o.body !== undefined ? JSON.stringify(o.body) : undefined;
71
+ const key = method === 'GET' || o.cacheable ? this.cacheKey(method, url, payload, o) : '';
72
+ if (key && this.cacheEnabled && this.cache.has(key)) {
73
+ log.debug('http.cache_hit', { url });
74
+ return this.cache.get(key).body;
75
+ }
76
+ const signal = o.signal ?? currentSignal();
77
+ if (signal?.aborted)
78
+ throw abortError();
79
+ if (!key)
80
+ return this.fetchWithRetry(url, method, o, payload, key, signal);
81
+ // Join an identical request already on the wire rather than queueing a second one.
82
+ let entry = this.inflight.get(key);
83
+ if (!entry) {
84
+ const controller = new AbortController();
85
+ const promise = this.fetchWithRetry(url, method, o, payload, key, controller.signal);
86
+ const created = { promise, controller, waiters: 0 };
87
+ const forget = () => { if (this.inflight.get(key) === created)
88
+ this.inflight.delete(key); };
89
+ created.forget = forget;
90
+ entry = created;
91
+ promise.then(forget, forget);
92
+ promise.catch(() => { });
93
+ this.inflight.set(key, created);
94
+ }
95
+ return this.wait(entry, signal);
96
+ }
97
+ /** One caller's view of a shared request: it may abort its own wait without failing others. */
98
+ wait(entry, signal) {
99
+ entry.waiters++;
100
+ if (!signal)
101
+ return entry.promise.finally(() => { entry.waiters--; });
102
+ return new Promise((resolve, reject) => {
103
+ let done = false;
104
+ const finish = () => { if (done)
105
+ return false; done = true; entry.waiters--; signal.removeEventListener('abort', onAbort); return true; };
106
+ const onAbort = () => {
107
+ if (!finish())
108
+ return;
109
+ // Once nobody waits, the shared request is dying: later identical calls must start their own.
110
+ if (entry.waiters === 0) {
111
+ entry.forget?.();
112
+ entry.controller.abort();
113
+ }
114
+ reject(abortError());
115
+ };
116
+ signal.addEventListener('abort', onAbort, { once: true });
117
+ entry.promise.then(v => { if (finish())
118
+ resolve(v); }, e => { if (finish())
119
+ reject(e); });
120
+ });
121
+ }
122
+ async fetchWithRetry(url, method, o, payload, key, signal) {
123
+ const accept = o.accept === 'xml' ? 'application/xml,text/xml'
124
+ : o.accept === 'text' ? 'text/plain,*/*;q=0.5'
125
+ : 'application/json';
126
+ let attempt = 0;
127
+ let retried429 = false;
128
+ for (;;) {
129
+ try {
130
+ return await this.attempt(url, method, o, payload, accept, key, signal);
131
+ }
132
+ catch (err) {
133
+ if (err instanceof GateTimeoutError || err instanceof ResponseTooLargeError || err?.name === 'AbortError')
134
+ throw err;
135
+ const status = err instanceof HttpError ? err.status : 0;
136
+ if (status === 429 && !err.budget) {
137
+ // attempt() already paused the gate before releasing its slot.
138
+ const wait = this.pauseFor(err);
139
+ if (!this.retry429 || retried429 || wait > MAX_RETRY_WAIT_MS)
140
+ throw err;
141
+ retried429 = true;
142
+ await sleep(wait, signal);
143
+ continue;
144
+ }
145
+ const retryable = status === 0 || status >= 500;
146
+ if (!retryable || attempt === this.retries)
147
+ throw err;
148
+ await sleep(Math.min(2 ** attempt * 250, 4000), signal);
149
+ attempt++;
150
+ }
151
+ }
152
+ }
153
+ /** How long every caller of this upstream must wait after a 429. */
154
+ pauseFor(err) {
155
+ return Math.min(MAX_GATE_PAUSE_MS, Math.max(this.min429PauseMs, err.retryAfterMs ?? 1000));
156
+ }
157
+ /** One request, holding a gate slot only while it is on the wire. */
158
+ async attempt(url, method, o, payload, accept, key, signal) {
159
+ let release;
160
+ if (this.gate) {
161
+ try {
162
+ release = await this.gate.acquire(signal);
163
+ }
164
+ catch (err) {
165
+ const e = err;
166
+ if (e?.name === 'AbortError')
167
+ throw abortError();
168
+ if (e?.name === 'Paused') {
169
+ const g = new GateTimeoutError(`${this.label} asked this server to wait ${Math.ceil((e.retryAfterMs ?? 0) / 1000)}s before calling again (rate limit). Retry later.`);
170
+ g.retryAfterMs = e.retryAfterMs;
171
+ throw g;
172
+ }
173
+ throw new GateTimeoutError(`${this.label} is busy: too many requests from this server are waiting. Make fewer calls per execute (USPTO allows one request at a time per API key) or retry shortly.`);
174
+ }
175
+ }
176
+ // Absolute deadline for this attempt: connecting, headers and the whole body. undici's own
177
+ // header/body timeouts are inactivity timers, which a slowly trickling response never trips.
178
+ const deadline = new AbortController();
179
+ const timer = setTimeout(() => deadline.abort(), this.timeoutMs);
180
+ const requestSignal = signal ? AbortSignal.any([signal, deadline.signal]) : deadline.signal;
181
+ try {
182
+ // Budgets count real upstream attempts (retries included), charged only once a request is
183
+ // admitted and about to be sent.
184
+ if (this.preflightLimiter && !(await this.preflightLimiter.tryTake())) {
185
+ const wait = this.preflightLimiter.secondsUntilNext?.() ?? 0;
186
+ const err = new HttpError(`${this.label}: this server's request budget for this API key is used up${Number.isFinite(wait) && wait > 0 ? ` (retry in ~${wait}s)` : ''}`, 429, '');
187
+ err.name = 'RateLimited';
188
+ err.budget = true;
189
+ throw err;
190
+ }
191
+ const res = await request(url, {
192
+ method,
193
+ headers: {
194
+ 'accept': accept,
195
+ 'accept-encoding': 'gzip',
196
+ 'user-agent': this.userAgent,
197
+ ...this.#defaultHeaders,
198
+ ...(o.form !== undefined ? { 'content-type': 'application/x-www-form-urlencoded' }
199
+ : o.body !== undefined ? { 'content-type': 'application/json' } : {}),
200
+ ...(o.headers ?? {}),
201
+ },
202
+ body: payload,
203
+ bodyTimeout: this.timeoutMs,
204
+ headersTimeout: this.timeoutMs,
205
+ signal: requestSignal,
206
+ ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
207
+ });
208
+ // A 429 pauses every caller now, from status and headers alone, before anything that could
209
+ // fail (body read, decoding) and before this slot is released.
210
+ if (res.statusCode === 429) {
211
+ const rawRetryAfter = Array.isArray(res.headers['retry-after']) ? res.headers['retry-after'][0] : res.headers['retry-after'];
212
+ const retryAfterMs = parseRetryAfter(rawRetryAfter);
213
+ // Header text is upstream-controlled: scrub and bound it before it reaches logs or errors.
214
+ const retryAfter = rawRetryAfter === undefined ? undefined : this.redact(String(rawRetryAfter)).slice(0, 64);
215
+ this.gate?.pause(Math.min(MAX_GATE_PAUSE_MS, Math.max(this.min429PauseMs, retryAfterMs ?? 1000)));
216
+ log.warn('upstream.rate_limited', { source: this.label, host: new URL(url).host, ...(retryAfter ? { retryAfter } : {}) });
217
+ // Best effort only, after the pause is in place: the upstream's own words, if readable.
218
+ let detail = '';
219
+ try {
220
+ const raw = await readCapped(res.body, res.headers['content-length'], 64 * 1024, `${method} ${url}`, true);
221
+ const gz = String(res.headers['content-encoding'] ?? '').trim().toLowerCase() === 'gzip';
222
+ detail = this.redact(new TextDecoder().decode(gz ? await decompressGzip(raw, { maxOutputLength: 64 * 1024 }) : raw)).slice(0, 2000);
223
+ }
224
+ catch { /* unreadable body: the status and headers were enough */ }
225
+ const err = new HttpError(`${this.label} is rate limiting this API key: ${method} ${stripQuery(url)} -> 429 Too Many Requests${retryAfter ? ` (retry-after ${retryAfter})` : ''}. USPTO allows one request at a time per key and a weekly quota; slow down and retry later.`, 429, detail);
226
+ err.name = 'RateLimited';
227
+ err.retryAfterMs = retryAfterMs;
228
+ throw err;
229
+ }
230
+ // undici.request returns raw bytes, unlike fetch. Decode before parsing,
231
+ // reporting upstream errors, or caching the response.
232
+ const raw = await readCapped(res.body, res.headers['content-length'], this.maxResponseBytes, `${method} ${url}`, res.statusCode >= 400);
233
+ const encoding = res.headers['content-encoding'];
234
+ const limit = res.statusCode >= 400 ? Math.min(this.maxResponseBytes, 64 * 1024) : this.maxResponseBytes;
235
+ let bytes = raw;
236
+ if (typeof encoding === 'string' && encoding.trim().toLowerCase() === 'gzip') {
237
+ // Bound the expansion itself, not just the compressed size.
238
+ try {
239
+ bytes = await decompressGzip(raw, { maxOutputLength: limit + 1 });
240
+ }
241
+ catch (err) {
242
+ if (err.code === 'ERR_BUFFER_TOO_LARGE')
243
+ throw new ResponseTooLargeError(`${method} ${url}`, this.maxResponseBytes);
244
+ throw err;
245
+ }
246
+ }
247
+ if (bytes.length > limit) {
248
+ if (res.statusCode < 400)
249
+ throw new ResponseTooLargeError(`${method} ${url}`, this.maxResponseBytes);
250
+ bytes = bytes.subarray(0, limit);
251
+ }
252
+ const text = this.redact(new TextDecoder().decode(bytes));
253
+ if (res.statusCode >= 400) {
254
+ const err = new HttpError(`${this.label}: ${method} ${stripQuery(url)} -> ${res.statusCode}${upstreamDetail(text)}`, res.statusCode, text.slice(0, 2000));
255
+ if (res.statusCode === 404)
256
+ err.name = 'NotFound';
257
+ if (res.statusCode === 401 || res.statusCode === 403) {
258
+ err.name = 'Unauthorized';
259
+ err.message = `${this.label} rejected the request (${res.statusCode}): the API key is missing, invalid, or not allowed to use this API.`;
260
+ }
261
+ err.message = this.redact(err.message);
262
+ throw err;
263
+ }
264
+ const contentType = String(res.headers['content-type'] ?? '');
265
+ let body;
266
+ if (accept.startsWith('application/json') || /json/i.test(contentType)) {
267
+ // Redact again after decoding: JSON escapes can spell a credential the raw scan missed.
268
+ try {
269
+ body = text.length ? this.redactValue(JSON.parse(text)) : null;
270
+ }
271
+ catch {
272
+ body = text;
273
+ }
274
+ }
275
+ else
276
+ body = text;
277
+ if (key && this.cacheEnabled)
278
+ this.cache.set(key, { status: res.statusCode, body, size: text.length });
279
+ return body;
280
+ }
281
+ catch (err) {
282
+ if (signal?.aborted)
283
+ throw abortError();
284
+ if (deadline.signal.aborted) {
285
+ const e = new HttpError(`${this.label}: ${method} ${stripQuery(url)} did not complete within ${this.timeoutMs} ms`, 0, '');
286
+ e.name = 'UpstreamTimeout';
287
+ throw e;
288
+ }
289
+ throw err;
290
+ }
291
+ finally {
292
+ clearTimeout(timer);
293
+ release?.();
294
+ }
295
+ }
296
+ /** Deep redaction of a decoded JSON value, including object keys. */
297
+ redactValue(value) {
298
+ if (!this.#secrets.length)
299
+ return value;
300
+ if (typeof value === 'string')
301
+ return this.redact(value);
302
+ if (Array.isArray(value))
303
+ return value.map(v => this.redactValue(v));
304
+ if (value && typeof value === 'object') {
305
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [this.redact(k), this.redactValue(v)]));
306
+ }
307
+ return value;
308
+ }
309
+ /** Replace any configured credential that an upstream echoes back. */
310
+ redact(text) {
311
+ let out = text;
312
+ for (const secret of this.#secrets)
313
+ if (out.includes(secret))
314
+ out = out.split(secret).join('[REDACTED]');
315
+ return out;
316
+ }
317
+ cacheKey(method, url, payload, o) {
318
+ const merged = { ...this.#defaultHeaders, ...(o.headers ?? {}) };
319
+ const normalized = {};
320
+ for (const [k, v] of Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)))
321
+ normalized[k.toLowerCase()] = v;
322
+ // Credentials are folded into a digest so the key never holds them in clear text, and two
323
+ // API keys never share cached responses.
324
+ const hash = createHash('sha256')
325
+ .update(JSON.stringify({ h: normalized, b: payload ?? null, a: o.accept ?? 'json', f: o.form !== undefined }))
326
+ .digest('hex').slice(0, 24);
327
+ return `${method} ${url}\n${hash}`;
328
+ }
329
+ buildUrl(path, query) {
330
+ const base = this.baseUrl.replace(/\/$/, '');
331
+ const p = path.startsWith('/') ? path : '/' + path;
332
+ const url = new URL(base + p);
333
+ if (query) {
334
+ for (const [k, v] of Object.entries(query)) {
335
+ if (v === undefined || v === null)
336
+ continue;
337
+ if (Array.isArray(v))
338
+ for (const item of v)
339
+ url.searchParams.append(k, String(item));
340
+ else
341
+ url.searchParams.append(k, String(v));
342
+ }
343
+ }
344
+ return url.toString();
345
+ }
346
+ }
347
+ function encodeForm(form) {
348
+ const p = new URLSearchParams();
349
+ for (const [k, v] of Object.entries(form))
350
+ if (v !== undefined && v !== null)
351
+ p.append(k, String(v));
352
+ return p.toString();
353
+ }
354
+ /** Error bodies can echo the query string; keep messages to the path. */
355
+ function stripQuery(url) {
356
+ const u = new URL(url);
357
+ return u.origin + u.pathname;
358
+ }
359
+ /** A short, human-readable reason from a USPTO JSON error body ({ error, errorDetails, message }). */
360
+ function upstreamDetail(text) {
361
+ try {
362
+ const j = JSON.parse(text);
363
+ const parts = [j.error, j.errorDetails, j.message, j.detailedMessage].filter(v => typeof v === 'string' && v.trim());
364
+ const detail = [...new Set(parts)].join(' — ').slice(0, 300);
365
+ return detail ? `: ${detail}` : '';
366
+ }
367
+ catch {
368
+ return '';
369
+ }
370
+ }
371
+ /** Read a response body, failing fast once it exceeds `max` bytes. */
372
+ async function readCapped(body, contentLength, max, what, isError) {
373
+ // Error bodies are only used for a short message; never buffer a huge one.
374
+ const limit = isError ? Math.min(max, 64 * 1024) : max;
375
+ const declared = Number(Array.isArray(contentLength) ? contentLength[0] : contentLength);
376
+ if (!isError && Number.isFinite(declared) && declared > limit) {
377
+ body.destroy?.();
378
+ throw new ResponseTooLargeError(what, max);
379
+ }
380
+ const chunks = [];
381
+ let size = 0;
382
+ for await (const chunk of body) {
383
+ size += chunk.length;
384
+ if (size > limit) {
385
+ body.destroy?.();
386
+ if (isError)
387
+ break;
388
+ throw new ResponseTooLargeError(what, max);
389
+ }
390
+ chunks.push(Buffer.from(chunk));
391
+ }
392
+ return Buffer.concat(chunks);
393
+ }
394
+ /** Retry-After as milliseconds: delta-seconds or an HTTP date; undefined if absent or invalid. */
395
+ export function parseRetryAfter(value) {
396
+ if (!value)
397
+ return undefined;
398
+ const v = value.trim();
399
+ // Check numerics first: Date.parse('1.5') is a valid date in V8 (2001), not 1.5 seconds.
400
+ if (/^\d+(\.\d+)?$/.test(v))
401
+ return Number(v) * 1000;
402
+ if (/^[\d.]+$/.test(v))
403
+ return undefined;
404
+ const at = Date.parse(v);
405
+ return Number.isNaN(at) ? undefined : Math.max(0, at - Date.now());
406
+ }
407
+ export class HttpError extends Error {
408
+ status;
409
+ bodySnippet;
410
+ retryAfterMs;
411
+ /** Raised by this server's own budget, not by the upstream: never retried, never pauses the gate. */
412
+ budget;
413
+ constructor(message, status, bodySnippet) {
414
+ super(message);
415
+ this.status = status;
416
+ this.bodySnippet = bodySnippet;
417
+ this.name = 'HttpError';
418
+ }
419
+ }
420
+ /** No gate slot freed up within maxWaitMs. Never retried: the queue is already full. */
421
+ class GateTimeoutError extends HttpError {
422
+ constructor(message) {
423
+ super(message, 429, '');
424
+ this.name = 'RateLimited';
425
+ }
426
+ }
427
+ /** The upstream body exceeded maxResponseBytes. Never retried. */
428
+ export class ResponseTooLargeError extends HttpError {
429
+ constructor(what, max) {
430
+ super(`${what.split('?')[0]} returned more than ${Math.round(max / 1024 / 1024)} MB. Request fewer results (smaller limit, or select fields) and paginate.`, 0, '');
431
+ this.name = 'ResponseTooLarge';
432
+ }
433
+ }
434
+ //# sourceMappingURL=httpClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"httpClient.js","sourceRoot":"","sources":["../../src/util/httpClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export declare const log: {
2
+ debug: (msg: string, extra?: Record<string, unknown>) => void;
3
+ info: (msg: string, extra?: Record<string, unknown>) => void;
4
+ warn: (msg: string, extra?: Record<string, unknown>) => void;
5
+ error: (msg: string, extra?: Record<string, unknown>) => void;
6
+ };
7
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,GAAG;IACd,KAAK,QAAQ,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,IAAI,QAAQ,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,IAAI,QAAQ,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,KAAK,QAAQ,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACrD,CAAC"}
@@ -0,0 +1,25 @@
1
+ const order = { debug: 10, info: 20, warn: 30, error: 40 };
2
+ function envLevel() {
3
+ const v = (process.env.USPTO_LOG_LEVEL ?? 'info').toLowerCase();
4
+ return ['debug', 'info', 'warn', 'error'].includes(v) ? v : 'info';
5
+ }
6
+ export const log = {
7
+ debug: (msg, extra) => write('debug', msg, extra),
8
+ info: (msg, extra) => write('info', msg, extra),
9
+ warn: (msg, extra) => write('warn', msg, extra),
10
+ error: (msg, extra) => write('error', msg, extra),
11
+ };
12
+ const RESERVED = new Set(['t', 'level', 'msg', 'message', 'timestamp']);
13
+ function write(level, msg, extra) {
14
+ if (order[level] < order[envLevel()])
15
+ return;
16
+ const fields = {};
17
+ // Extras never overwrite the envelope. `message`/`timestamp` are reserved too: log
18
+ // platforms (Railway) map `msg` onto `message`, which would silently drop an extra `message`.
19
+ for (const [k, v] of Object.entries(extra ?? {}))
20
+ fields[RESERVED.has(k) ? `extra_${k}` : k] = v;
21
+ const line = JSON.stringify({ t: new Date().toISOString(), level, msg, ...fields });
22
+ // stdio transport reserves stdout for JSON-RPC; log to stderr.
23
+ process.stderr.write(line + '\n');
24
+ }
25
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AACA,MAAM,KAAK,GAA0B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAElF,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,OAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAa,CAAC,QAAQ,CAAC,CAAU,CAAC,CAAC,CAAC,CAAE,CAAW,CAAC,CAAC,CAAC,MAAM,CAAC;AACtG,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,CAAC,GAAW,EAAE,KAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;IACnF,IAAI,EAAE,CAAC,GAAW,EAAE,KAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjF,IAAI,EAAE,CAAC,GAAW,EAAE,KAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjF,KAAK,EAAE,CAAC,GAAW,EAAE,KAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;CACpF,CAAC;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAExE,SAAS,KAAK,CAAC,KAAY,EAAE,GAAW,EAAE,KAA+B;IACvE,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAAE,OAAO;IAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,mFAAmF;IACnF,8FAA8F;IAC9F,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjG,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpF,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}
@@ -0,0 +1,13 @@
1
+ export declare class SubjectQuota {
2
+ private readonly limit;
3
+ private readonly windowMs;
4
+ private readonly counts;
5
+ constructor(limit: number, windowMs?: number);
6
+ /** Returns whether the subject may make one more request in the current window. */
7
+ consume(subject: string): {
8
+ allowed: boolean;
9
+ remaining: number;
10
+ resetAt: number;
11
+ };
12
+ }
13
+ //# sourceMappingURL=quotas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quotas.d.ts","sourceRoot":"","sources":["../../src/util/quotas.ts"],"names":[],"mappings":"AAIA,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAU,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAC9E,YAA6B,KAAK,EAAE,MAAM,EAAmB,QAAQ,GAAE,MAAe,EAErF;IAED,mFAAmF;IACnF,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAcjF;CACF"}
@@ -0,0 +1,29 @@
1
+ import { LRUCache } from 'lru-cache';
2
+ const DAY_MS = 24 * 60 * 60 * 1000;
3
+ export class SubjectQuota {
4
+ limit;
5
+ windowMs;
6
+ counts;
7
+ constructor(limit, windowMs = DAY_MS) {
8
+ this.limit = limit;
9
+ this.windowMs = windowMs;
10
+ this.counts = new LRUCache({ max: 10_000, ttl: windowMs });
11
+ }
12
+ /** Returns whether the subject may make one more request in the current window. */
13
+ consume(subject) {
14
+ const now = Date.now();
15
+ const rec = this.counts.get(subject);
16
+ if (!rec || rec.resetAt < now) {
17
+ const resetAt = now + this.windowMs;
18
+ this.counts.set(subject, { count: 1, resetAt });
19
+ return { allowed: true, remaining: this.limit - 1, resetAt };
20
+ }
21
+ if (rec.count >= this.limit) {
22
+ return { allowed: false, remaining: 0, resetAt: rec.resetAt };
23
+ }
24
+ rec.count++;
25
+ this.counts.set(subject, rec);
26
+ return { allowed: true, remaining: this.limit - rec.count, resetAt: rec.resetAt };
27
+ }
28
+ }
29
+ //# sourceMappingURL=quotas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quotas.js","sourceRoot":"","sources":["../../src/util/quotas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,MAAM,OAAO,YAAY;IAEM,KAAK;IAA2B,QAAQ;IADpD,MAAM,CAAuD;IAC9E,YAA6B,KAAa,EAAmB,QAAQ,GAAW,MAAM;qBAAzD,KAAK;wBAA2B,QAAQ;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,mFAAmF;IACnF,OAAO,CAAC,OAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAChE,CAAC;QACD,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACpF,CAAC;CACF"}
@@ -0,0 +1,11 @@
1
+ /** In-memory token bucket. One instance = one shared limit (e.g. process-wide quota for a shared API key). */
2
+ export declare class TokenBucket {
3
+ private readonly ratePerSec;
4
+ private readonly burst;
5
+ private tokens;
6
+ private updatedAt;
7
+ constructor(ratePerSec: number, burst: number);
8
+ tryTake(): boolean;
9
+ secondsUntilNext(): number;
10
+ }
11
+ //# sourceMappingURL=tokenBucket.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokenBucket.d.ts","sourceRoot":"","sources":["../../src/util/tokenBucket.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAU,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFvE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,YAA6B,UAAU,EAAE,MAAM,EAAmB,KAAK,EAAE,MAAM,EAG9E;IACD,OAAO,IAAI,OAAO,CAOjB;IACD,gBAAgB,IAAI,MAAM,CAIzB;CACF"}
@@ -0,0 +1,30 @@
1
+ /** In-memory token bucket. One instance = one shared limit (e.g. process-wide quota for a shared API key). */
2
+ export class TokenBucket {
3
+ ratePerSec;
4
+ burst;
5
+ tokens;
6
+ updatedAt;
7
+ constructor(ratePerSec, burst) {
8
+ this.ratePerSec = ratePerSec;
9
+ this.burst = burst;
10
+ this.tokens = burst;
11
+ this.updatedAt = Date.now();
12
+ }
13
+ tryTake() {
14
+ const now = Date.now();
15
+ this.tokens = Math.min(this.burst, this.tokens + ((now - this.updatedAt) / 1000) * this.ratePerSec);
16
+ this.updatedAt = now;
17
+ if (this.tokens < 1)
18
+ return false;
19
+ this.tokens -= 1;
20
+ return true;
21
+ }
22
+ secondsUntilNext() {
23
+ if (this.tokens >= 1)
24
+ return 0;
25
+ if (this.ratePerSec <= 0)
26
+ return Infinity;
27
+ return Math.ceil((1 - this.tokens) / this.ratePerSec);
28
+ }
29
+ }
30
+ //# sourceMappingURL=tokenBucket.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokenBucket.js","sourceRoot":"","sources":["../../src/util/tokenBucket.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,OAAO,WAAW;IAGO,UAAU;IAA2B,KAAK;IAF/D,MAAM,CAAS;IACf,SAAS,CAAS;IAC1B,YAA6B,UAAkB,EAAmB,KAAa;0BAAlD,UAAU;qBAA2B,KAAK;QACrE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACpG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,gBAAgB;QACd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;CACF"}