@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,8 @@
1
+ import type { CorpusEntry } from '../../search/corpus.js';
2
+ type SourceCorpus = {
3
+ endpoints: CorpusEntry[];
4
+ fields: CorpusEntry[];
5
+ };
6
+ export declare function loadSourceCorpus(name: string): SourceCorpus;
7
+ export {};
8
+ //# sourceMappingURL=corpus-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"corpus-loader.d.ts","sourceRoot":"","sources":["../../../src/sdk/sources/corpus-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,KAAK,YAAY,GAAG;IAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAMxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAQ3D"}
@@ -0,0 +1,17 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { fileURLToPath } from 'node:url';
3
+ import { dirname, resolve } from 'node:path';
4
+ const __dirname = dirname(fileURLToPath(import.meta.url));
5
+ // The corpus files are static; parse each once. Source factories run more than once
6
+ // (buildSupervisor builds sources twice, and account mode builds keyed sources per account key).
7
+ const cache = new Map();
8
+ export function loadSourceCorpus(name) {
9
+ let corpus = cache.get(name);
10
+ if (!corpus) {
11
+ const path = resolve(__dirname, `../../../schema/${name}.json`);
12
+ corpus = JSON.parse(readFileSync(path, 'utf8'));
13
+ cache.set(name, corpus);
14
+ }
15
+ return corpus;
16
+ }
17
+ //# sourceMappingURL=corpus-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"corpus-loader.js","sourceRoot":"","sources":["../../../src/sdk/sources/corpus-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAI1D,oFAAoF;AACpF,iGAAiG;AACjG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,mBAAmB,IAAI,OAAO,CAAC,CAAC;QAChE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;QAChE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,8 @@
1
+ import type { Source, SourceConfig } from './source.js';
2
+ export type { Source, SourceMeta, SourceConfig, KeyedUpstream, SourceName } from './source.js';
3
+ export { SOURCE_NAMES } from './source.js';
4
+ export declare function validateSourceNames(sources: {
5
+ name: string;
6
+ }[]): void;
7
+ export declare function getSources(cfg: SourceConfig): Source[];
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/sources/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,IAAI,CAQrE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAItD"}
@@ -0,0 +1,25 @@
1
+ import { BANNED_GLOBALS } from '../../sandbox/policy.js';
2
+ import { createOdpSource } from './odp.js';
3
+ import { createTsdrSource } from './tsdr.js';
4
+ export { SOURCE_NAMES } from './source.js';
5
+ const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
6
+ // `global`/`globalThis` are already in BANNED_GLOBALS; `console` is the only extra collision.
7
+ const NAME_DENYLIST = new Set([...BANNED_GLOBALS, 'console']);
8
+ export function validateSourceNames(sources) {
9
+ const seen = new Set();
10
+ for (const s of sources) {
11
+ if (!IDENTIFIER.test(s.name))
12
+ throw new Error(`Invalid source name '${s.name}': must be a JS identifier`);
13
+ if (NAME_DENYLIST.has(s.name))
14
+ throw new Error(`Source name '${s.name}' is not allowed (collides with a sandbox global)`);
15
+ if (seen.has(s.name))
16
+ throw new Error(`Duplicate source name '${s.name}'`);
17
+ seen.add(s.name);
18
+ }
19
+ }
20
+ export function getSources(cfg) {
21
+ const sources = [createOdpSource(cfg), createTsdrSource(cfg)];
22
+ validateSourceNames(sources);
23
+ return sources;
24
+ }
25
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,8FAA8F;AAC9F,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;AAEtE,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,IAAI,4BAA4B,CAAC,CAAC;QAC1G,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,mDAAmD,CAAC,CAAC;QAC1H,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3E,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAiB;IAC1C,MAAM,OAAO,GAAa,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { Source, SourceConfig } from './source.js';
2
+ export declare const ODP_LABEL = "USPTO Open Data Portal";
3
+ export declare const ODP_BASE_URL = "https://api.uspto.gov";
4
+ export declare function createOdpSource(cfg: SourceConfig): Source;
5
+ //# sourceMappingURL=odp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"odp.d.ts","sourceRoot":"","sources":["../../../src/sdk/sources/odp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,SAAS,2BAA2B,CAAC;AAClD,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAEpD,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAuEzD"}
@@ -0,0 +1,78 @@
1
+ import { HttpClient } from '../../util/httpClient.js';
2
+ import { OdpClient } from '../odp-client.js';
3
+ import { loadSourceCorpus } from './corpus-loader.js';
4
+ export const ODP_LABEL = 'USPTO Open Data Portal';
5
+ export const ODP_BASE_URL = 'https://api.uspto.gov';
6
+ export function createOdpSource(cfg) {
7
+ const key = cfg.odp.apiKey?.trim();
8
+ const enabled = Boolean(key);
9
+ const http = new HttpClient({
10
+ baseUrl: cfg.odp.baseUrl, userAgent: cfg.userAgent, timeoutMs: cfg.timeoutMs,
11
+ retries: cfg.retries, cacheTtlMs: cfg.cacheTtlMs, cacheMaxItems: cfg.cacheMaxItems,
12
+ ...(cfg.maxResponseBytes ? { maxResponseBytes: cfg.maxResponseBytes } : {}),
13
+ ...(cfg.cacheMaxBytes ? { cacheMaxBytes: cfg.cacheMaxBytes } : {}),
14
+ // USPTO: "We strongly discourage automatic retries, without at least 5 second delay" after a 429.
15
+ // Every caller of this key pauses >= 5 s (or Retry-After), then a request is retried once.
16
+ // Observed live: a 429 can arrive even at one request in flight and the documented rate.
17
+ retry429: true, min429PauseMs: 5000, label: ODP_LABEL,
18
+ ...(enabled ? { defaultHeaders: { 'X-API-KEY': key } } : {}),
19
+ ...(cfg.odp.preflightLimiter ? { preflightLimiter: cfg.odp.preflightLimiter } : {}),
20
+ ...(cfg.odp.gate ? { gate: cfg.odp.gate } : {}),
21
+ ...(cfg.dispatcher ? { dispatcher: cfg.dispatcher } : {}),
22
+ });
23
+ const client = new OdpClient(http);
24
+ const { patents, ptab, petitions, officeActions, oa, bulk } = client;
25
+ return {
26
+ name: 'odp',
27
+ label: ODP_LABEL,
28
+ enabled,
29
+ disabledReason: enabled ? undefined : 'The USPTO Open Data Portal requires an API key. Set USPTO_API_KEY (free: sign in at https://data.uspto.gov/myodp, verify with ID.me, then request a key).',
30
+ client,
31
+ methods: Object.freeze({
32
+ 'patents.search': patents.search,
33
+ 'patents.get': patents.get,
34
+ 'patents.byPatentNumber': patents.byPatentNumber,
35
+ 'patents.metaData': patents.metaData,
36
+ 'patents.adjustment': patents.adjustment,
37
+ 'patents.assignment': patents.assignment,
38
+ 'patents.attorney': patents.attorney,
39
+ 'patents.continuity': patents.continuity,
40
+ 'patents.foreignPriority': patents.foreignPriority,
41
+ 'patents.transactions': patents.transactions,
42
+ 'patents.documents': patents.documents,
43
+ 'patents.associatedDocuments': patents.associatedDocuments,
44
+ 'patents.statusCodes': patents.statusCodes,
45
+ 'ptab.proceedings.search': ptab.proceedings.search,
46
+ 'ptab.proceedings.get': ptab.proceedings.get,
47
+ 'ptab.decisions.search': ptab.decisions.search,
48
+ 'ptab.decisions.get': ptab.decisions.get,
49
+ 'ptab.decisions.byTrial': ptab.decisions.byTrial,
50
+ 'ptab.documents.search': ptab.documents.search,
51
+ 'ptab.documents.get': ptab.documents.get,
52
+ 'ptab.documents.byTrial': ptab.documents.byTrial,
53
+ 'ptab.appeals.search': ptab.appeals.search,
54
+ 'ptab.appeals.get': ptab.appeals.get,
55
+ 'ptab.appeals.byAppeal': ptab.appeals.byAppeal,
56
+ 'ptab.interferences.search': ptab.interferences.search,
57
+ 'ptab.interferences.get': ptab.interferences.get,
58
+ 'ptab.interferences.byInterference': ptab.interferences.byInterference,
59
+ 'petitions.search': petitions.search,
60
+ 'petitions.get': petitions.get,
61
+ 'officeActions.search': officeActions.search,
62
+ 'officeActions.get': officeActions.get,
63
+ 'officeActions.text': officeActions.text,
64
+ 'oa.text.search': oa.text.search,
65
+ 'oa.text.fields': oa.text.fields,
66
+ 'oa.citations.search': oa.citations.search,
67
+ 'oa.citations.fields': oa.citations.fields,
68
+ 'oa.rejections.search': oa.rejections.search,
69
+ 'oa.rejections.fields': oa.rejections.fields,
70
+ 'oa.enrichedCitations.search': oa.enrichedCitations.search,
71
+ 'oa.enrichedCitations.fields': oa.enrichedCitations.fields,
72
+ 'bulk.search': bulk.search,
73
+ 'bulk.get': bulk.get,
74
+ }),
75
+ corpus: loadSourceCorpus('odp'),
76
+ };
77
+ }
78
+ //# sourceMappingURL=odp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"odp.js","sourceRoot":"","sources":["../../../src/sdk/sources/odp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import type { Dispatcher } from 'undici';
2
+ import type { CorpusEntry } from '../../search/corpus.js';
3
+ import type { PreflightLimiter, UpstreamGateLike } from '../../util/httpClient.js';
4
+ export interface SourceMeta {
5
+ name: string;
6
+ label: string;
7
+ enabled: boolean;
8
+ disabledReason?: string;
9
+ }
10
+ export interface Source extends SourceMeta {
11
+ client: object;
12
+ methods: RpcMethods;
13
+ corpus: {
14
+ endpoints: CorpusEntry[];
15
+ fields: CorpusEntry[];
16
+ };
17
+ }
18
+ export type RpcMethods = Readonly<Record<string, (...args: any[]) => unknown>>;
19
+ /** One API-key-gated upstream. The key stays host-side, inside the source's HttpClient. */
20
+ export interface KeyedUpstream {
21
+ baseUrl: string;
22
+ apiKey?: string;
23
+ /** Hourly budget check, run after the response cache (process-wide, or per account). */
24
+ preflightLimiter?: PreflightLimiter;
25
+ /** Per-key admission control: USPTO allows one request in flight per API key. */
26
+ gate?: UpstreamGateLike;
27
+ }
28
+ export interface SourceConfig {
29
+ odp: KeyedUpstream;
30
+ tsdr: KeyedUpstream;
31
+ userAgent: string;
32
+ timeoutMs: number;
33
+ retries: number;
34
+ cacheTtlMs: number;
35
+ cacheMaxItems: number;
36
+ /** Summed size bound for one client's response cache. */
37
+ cacheMaxBytes?: number;
38
+ maxResponseBytes?: number;
39
+ dispatcher?: Dispatcher;
40
+ }
41
+ /** Names of the keyed sources, i.e. every source this server registers. */
42
+ export declare const SOURCE_NAMES: readonly ['odp', 'tsdr'];
43
+ export type SourceName = typeof SOURCE_NAMES[number];
44
+ //# sourceMappingURL=source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/sdk/sources/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE;QAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;CAC7D;AAID,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;AAE/E,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iFAAiF;IACjF,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,aAAa,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,YAAI,KAAK,EAAE,MAAM,CAAU,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Names of the keyed sources, i.e. every source this server registers. */
2
+ export const SOURCE_NAMES = ['odp', 'tsdr'];
3
+ //# sourceMappingURL=source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/sdk/sources/source.ts"],"names":[],"mappings":"AA6CA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { Source, SourceConfig } from './source.js';
2
+ export declare const TSDR_LABEL = "USPTO TSDR (trademarks)";
3
+ export declare const TSDR_BASE_URL = "https://tsdrapi.uspto.gov";
4
+ export declare function createTsdrSource(cfg: SourceConfig): Source;
5
+ //# sourceMappingURL=tsdr.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tsdr.d.ts","sourceRoot":"","sources":["../../../src/sdk/sources/tsdr.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,UAAU,4BAA4B,CAAC;AACpD,eAAO,MAAM,aAAa,8BAA8B,CAAC;AAEzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CA+B1D"}
@@ -0,0 +1,38 @@
1
+ import { HttpClient } from '../../util/httpClient.js';
2
+ import { TsdrClient } from '../tsdr-client.js';
3
+ import { loadSourceCorpus } from './corpus-loader.js';
4
+ export const TSDR_LABEL = 'USPTO TSDR (trademarks)';
5
+ export const TSDR_BASE_URL = 'https://tsdrapi.uspto.gov';
6
+ export function createTsdrSource(cfg) {
7
+ const key = cfg.tsdr.apiKey?.trim();
8
+ const enabled = Boolean(key);
9
+ const http = new HttpClient({
10
+ baseUrl: cfg.tsdr.baseUrl, userAgent: cfg.userAgent, timeoutMs: cfg.timeoutMs,
11
+ retries: cfg.retries, cacheTtlMs: cfg.cacheTtlMs, cacheMaxItems: cfg.cacheMaxItems,
12
+ ...(cfg.maxResponseBytes ? { maxResponseBytes: cfg.maxResponseBytes } : {}),
13
+ ...(cfg.cacheMaxBytes ? { cacheMaxBytes: cfg.cacheMaxBytes } : {}),
14
+ // Same policy as ODP: pause every caller >= 5 s after a 429, then retry once.
15
+ retry429: true, min429PauseMs: 5000, label: TSDR_LABEL,
16
+ ...(enabled ? { defaultHeaders: { 'USPTO-API-KEY': key } } : {}),
17
+ ...(cfg.tsdr.preflightLimiter ? { preflightLimiter: cfg.tsdr.preflightLimiter } : {}),
18
+ ...(cfg.tsdr.gate ? { gate: cfg.tsdr.gate } : {}),
19
+ ...(cfg.dispatcher ? { dispatcher: cfg.dispatcher } : {}),
20
+ });
21
+ const client = new TsdrClient(http);
22
+ return {
23
+ name: 'tsdr',
24
+ label: TSDR_LABEL,
25
+ enabled,
26
+ disabledReason: enabled ? undefined : 'TSDR requires its own API key (separate from the ODP key). Set USPTO_TSDR_API_KEY (free at https://account.uspto.gov/api-manager).',
27
+ client,
28
+ methods: Object.freeze({
29
+ status: client.status,
30
+ multiStatus: client.multiStatus,
31
+ documents: client.documents,
32
+ documentInfo: client.documentInfo,
33
+ lastUpdate: client.lastUpdate,
34
+ }),
35
+ corpus: loadSourceCorpus('tsdr'),
36
+ };
37
+ }
38
+ //# sourceMappingURL=tsdr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tsdr.js","sourceRoot":"","sources":["../../../src/sdk/sources/tsdr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,CAAC,MAAM,UAAU,GAAG,yBAAyB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAEzD,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS;QAC7E,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa;QAClF,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,8EAA8E;QAC9E,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU;QACtD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,eAAe,EAAE,GAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,UAAU;QACjB,OAAO;QACP,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oIAAoI;QAC1K,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;KACjC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { HttpClient } from '../util/httpClient.js';
2
+ /**
3
+ * TSDR case id: 'sn' + 8-digit serial number, 'rn' + registration number (up to 8 digits),
4
+ * 'ref' + Madrid reference number (letters and digits, e.g. 'refZ1231384'), or 'ir' + international
5
+ * registration number. A bare 8-digit number is treated as a serial number, 7 or fewer digits as a
6
+ * registration number. The prefix is case-insensitive; a reference number keeps its case.
7
+ */
8
+ export declare function normalizeCaseId(value: unknown): string;
9
+ /** Trademark Status & Document Retrieval (tsdrapi.uspto.gov). Separate key from ODP. */
10
+ export declare class TsdrClient {
11
+ private readonly http;
12
+ constructor(http: HttpClient);
13
+ /** Case status and bibliographic data (marks, owners, goods & services, prosecution events) as JSON. */
14
+ status: (caseId: string) => Promise<unknown>;
15
+ /** Status for up to 25 cases of one number type ('sn' | 'rn' | 'ref' | 'ir') in one call. */
16
+ multiStatus: (type: string, ids: string[]) => Promise<unknown>;
17
+ /** The case's document list (metadata for each filing, office action, etc.) as XML text. */
18
+ documents: (caseId: string) => Promise<unknown>;
19
+ /** Metadata for one document in a case, as XML text. */
20
+ documentInfo: (caseId: string, documentId: string) => Promise<unknown>;
21
+ /** When the case's prosecution history last changed. Serial numbers only. */
22
+ lastUpdate: (serialNumber: string) => Promise<unknown>;
23
+ }
24
+ //# sourceMappingURL=tsdr-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tsdr-client.d.ts","sourceRoot":"","sources":["../../src/sdk/tsdr-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWtD;AAID,wFAAwF;AACxF,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,UAAU,EAAI;IAEjD,wGAAwG;IACxG,MAAM,WAAY,MAAM,sBACwE;IAEhG,6FAA6F;IAC7F,WAAW,SAAU,MAAM,OAAO,MAAM,EAAE,sBASxC;IAEF,4FAA4F;IAC5F,SAAS,WAAY,MAAM,sBACkE;IAE7F,wDAAwD;IACxD,YAAY,WAAY,MAAM,cAAc,MAAM,sBAGhD;IAEF,6EAA6E;IAC7E,UAAU,iBAAkB,MAAM,sBAIhC;CACH"}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * TSDR case id: 'sn' + 8-digit serial number, 'rn' + registration number (up to 8 digits),
3
+ * 'ref' + Madrid reference number (letters and digits, e.g. 'refZ1231384'), or 'ir' + international
4
+ * registration number. A bare 8-digit number is treated as a serial number, 7 or fewer digits as a
5
+ * registration number. The prefix is case-insensitive; a reference number keeps its case.
6
+ */
7
+ export function normalizeCaseId(value) {
8
+ if (typeof value !== 'string' && typeof value !== 'number')
9
+ throw new TypeError('caseId must be a string');
10
+ const v = String(value).trim().replace(/[\s,]/g, '');
11
+ let m;
12
+ if ((m = /^sn(\d{8})$/i.exec(v)))
13
+ return `sn${m[1]}`;
14
+ if ((m = /^rn(\d{1,8})$/i.exec(v)))
15
+ return `rn${m[1].padStart(7, '0')}`;
16
+ if ((m = /^ir(\d{1,10})$/i.exec(v)))
17
+ return `ir${m[1]}`;
18
+ if ((m = /^ref([A-Za-z0-9]{1,20})$/i.exec(v)))
19
+ return `ref${m[1]}`;
20
+ if (/^\d{8}$/.test(v))
21
+ return `sn${v}`;
22
+ if (/^\d{1,7}$/.test(v))
23
+ return `rn${v.padStart(7, '0')}`;
24
+ throw new TypeError(`Unrecognized trademark case id '${String(value).slice(0, 50)}'. Use 'sn' + serial number (e.g. 'sn97123456'), 'rn' + registration number (e.g. 'rn6123456'), 'ref' + Madrid reference number, or 'ir' + international registration number.`);
25
+ }
26
+ const MULTI_TYPES = new Set(['sn', 'rn', 'ref', 'ir']);
27
+ /** Trademark Status & Document Retrieval (tsdrapi.uspto.gov). Separate key from ODP. */
28
+ export class TsdrClient {
29
+ http;
30
+ constructor(http) {
31
+ this.http = http;
32
+ }
33
+ /** Case status and bibliographic data (marks, owners, goods & services, prosecution events) as JSON. */
34
+ status = (caseId) => this.http.call({ path: `/ts/cd/casestatus/${normalizeCaseId(caseId)}/info`, accept: 'json' });
35
+ /** Status for up to 25 cases of one number type ('sn' | 'rn' | 'ref' | 'ir') in one call. */
36
+ multiStatus = (type, ids) => {
37
+ if (!MULTI_TYPES.has(type))
38
+ throw new TypeError("type must be one of 'sn', 'rn', 'ref', 'ir'");
39
+ if (!Array.isArray(ids) || ids.length === 0 || ids.length > 25)
40
+ throw new RangeError('ids must be an array of 1 to 25 numbers');
41
+ const clean = ids.map(id => {
42
+ const s = String(id).trim().replace(/[\s,]/g, '');
43
+ if (!/^[A-Za-z0-9]{1,20}$/.test(s))
44
+ throw new TypeError(`Invalid id '${id}'`);
45
+ return s;
46
+ });
47
+ return this.http.call({ path: `/ts/cd/caseMultiStatus/${type}`, query: { ids: clean.join(',') }, accept: 'json' });
48
+ };
49
+ /** The case's document list (metadata for each filing, office action, etc.) as XML text. */
50
+ documents = (caseId) => this.http.call({ path: `/ts/cd/casedocs/${normalizeCaseId(caseId)}/info`, accept: 'xml' });
51
+ /** Metadata for one document in a case, as XML text. */
52
+ documentInfo = (caseId, documentId) => {
53
+ if (typeof documentId !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9_.-]{0,99}$/.test(documentId))
54
+ throw new TypeError('documentId must be a TSDR document id');
55
+ return this.http.call({ path: `/ts/cd/casedoc/${normalizeCaseId(caseId)}/${documentId}/info`, accept: 'xml' });
56
+ };
57
+ /** When the case's prosecution history last changed. Serial numbers only. */
58
+ lastUpdate = (serialNumber) => {
59
+ const sn = String(serialNumber ?? '').trim().toLowerCase().replace(/^sn/, '');
60
+ if (!/^\d{8}$/.test(sn))
61
+ throw new TypeError('serialNumber must be an 8-digit trademark serial number');
62
+ return this.http.call({ path: '/last-update/info.json', query: { sn }, accept: 'json' });
63
+ };
64
+ }
65
+ //# sourceMappingURL=tsdr-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tsdr-client.js","sourceRoot":"","sources":["../../src/sdk/tsdr-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Tiny BM25 implementation. No external deps.
3
+ */
4
+ export interface Doc {
5
+ id: string;
6
+ text: string;
7
+ }
8
+ export interface ScoredDoc {
9
+ id: string;
10
+ score: number;
11
+ }
12
+ export declare function tokenize(s: string): string[];
13
+ export declare class Bm25Index {
14
+ private readonly docs;
15
+ private readonly tokens;
16
+ private readonly df;
17
+ private avgdl;
18
+ private N;
19
+ private k1;
20
+ private b;
21
+ add(doc: Doc): void;
22
+ search(query: string, k?: number): ScoredDoc[];
23
+ get(id: string): Doc | undefined;
24
+ }
25
+ //# sourceMappingURL=bm25.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5C;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkC;IACrD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,CAAC,CAAK;IACd,OAAO,CAAC,EAAE,CAAO;IACjB,OAAO,CAAC,CAAC,CAAQ;IAEjB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAclB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,SAAS,EAAE,CAqBzC;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAE/B;CACF"}
@@ -0,0 +1,67 @@
1
+ const STOP = new Set([
2
+ 'a', 'an', 'and', 'are', 'as', 'at', 'be', 'by', 'for', 'from', 'has', 'have', 'i', 'in', 'is', 'it', 'its', 'of', 'on', 'or', 'that',
3
+ 'the', 'to', 'was', 'were', 'will', 'with', 'this', 'these', 'those', 'if', 'then', 'than', 'so', 'do', 'does', 'can', 'should'
4
+ ]);
5
+ export function tokenize(s) {
6
+ return s
7
+ .toLowerCase()
8
+ .replace(/[^a-z0-9_\s-]/g, ' ')
9
+ .split(/\s+/)
10
+ .filter(t => t && t.length > 1 && !STOP.has(t));
11
+ }
12
+ export class Bm25Index {
13
+ docs = new Map();
14
+ tokens = new Map(); // doc id -> tokens
15
+ df = new Map(); // term -> doc freq
16
+ avgdl = 0;
17
+ N = 0;
18
+ k1 = 1.5;
19
+ b = 0.75;
20
+ add(doc) {
21
+ const toks = tokenize(doc.text);
22
+ this.docs.set(doc.id, doc);
23
+ this.tokens.set(doc.id, toks);
24
+ const seen = new Set();
25
+ for (const t of toks) {
26
+ if (seen.has(t))
27
+ continue;
28
+ seen.add(t);
29
+ this.df.set(t, (this.df.get(t) ?? 0) + 1);
30
+ }
31
+ this.N = this.docs.size;
32
+ let total = 0;
33
+ for (const v of this.tokens.values())
34
+ total += v.length;
35
+ this.avgdl = total / Math.max(this.N, 1);
36
+ }
37
+ search(query, k = 10) {
38
+ const qt = tokenize(query);
39
+ if (qt.length === 0)
40
+ return [];
41
+ const results = [];
42
+ for (const [id, toks] of this.tokens) {
43
+ let score = 0;
44
+ const dl = toks.length;
45
+ const tf = new Map();
46
+ for (const t of toks)
47
+ tf.set(t, (tf.get(t) ?? 0) + 1);
48
+ for (const term of qt) {
49
+ const f = tf.get(term);
50
+ if (!f)
51
+ continue;
52
+ const n = this.df.get(term) ?? 0;
53
+ const idf = Math.log((this.N - n + 0.5) / (n + 0.5) + 1);
54
+ const denom = f + this.k1 * (1 - this.b + this.b * (dl / Math.max(this.avgdl, 1)));
55
+ score += idf * ((f * (this.k1 + 1)) / denom);
56
+ }
57
+ if (score > 0)
58
+ results.push({ id, score });
59
+ }
60
+ results.sort((a, b) => b.score - a.score);
61
+ return results.slice(0, k);
62
+ }
63
+ get(id) {
64
+ return this.docs.get(id);
65
+ }
66
+ }
67
+ //# sourceMappingURL=bm25.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { Bm25Index } from './bm25.js';
2
+ export interface CorpusEntry {
3
+ id: string;
4
+ kind: 'endpoint' | 'field';
5
+ binding: string;
6
+ description: string;
7
+ example?: string;
8
+ signature?: string;
9
+ }
10
+ export interface Corpus {
11
+ index: Bm25Index;
12
+ entries: Map<string, CorpusEntry>;
13
+ }
14
+ export declare function buildCorpus(sources: Array<{
15
+ corpus: {
16
+ endpoints: CorpusEntry[];
17
+ fields: CorpusEntry[];
18
+ };
19
+ }>): Corpus;
20
+ export declare function lookupByPathOrPrefix(entries: Map<string, CorpusEntry>, target: {
21
+ path?: string;
22
+ prefix?: string;
23
+ }): CorpusEntry[];
24
+ //# sourceMappingURL=corpus.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/search/corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACnC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE;QAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC,GAAG,MAAM,CAUnH;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CAQjI"}
@@ -0,0 +1,23 @@
1
+ import { Bm25Index } from './bm25.js';
2
+ export function buildCorpus(sources) {
3
+ const index = new Bm25Index();
4
+ const entries = new Map();
5
+ for (const s of sources) {
6
+ for (const e of [...s.corpus.endpoints, ...s.corpus.fields]) {
7
+ entries.set(e.id, e);
8
+ index.add({ id: e.id, text: [e.id, e.description, e.signature ?? '', e.example ?? ''].join(' ') });
9
+ }
10
+ }
11
+ return { index, entries };
12
+ }
13
+ export function lookupByPathOrPrefix(entries, target) {
14
+ const all = [...entries.values()];
15
+ if (target.path) {
16
+ const hit = entries.get(target.path);
17
+ return hit ? [hit] : [];
18
+ }
19
+ if (target.prefix)
20
+ return all.filter(e => e.id.startsWith(target.prefix));
21
+ return [];
22
+ }
23
+ //# sourceMappingURL=corpus.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"corpus.js","sourceRoot":"","sources":["../../src/search/corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgBtC,MAAM,UAAU,WAAW,CAAC,OAA+E;IACzG,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACrB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAiC,EAAE,MAA0C;IAChH,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,MAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,EAAE,CAAC;AACZ,CAAC"}
@@ -0,0 +1,40 @@
1
+ import { type JWTPayload, type JWTVerifyGetKey } from 'jose';
2
+ /** Bearer-token verification for the base HTTP transport. `none` is only valid with --insecure. */
3
+ export declare const AUTH_PROVIDERS: readonly ['none', 'generic-oidc', 'clerk', 'workos', 'auth0'];
4
+ export type AuthProvider = typeof AUTH_PROVIDERS[number];
5
+ export interface AuthConfig {
6
+ provider: AuthProvider;
7
+ /** Trusted token issuer (`iss`). Required for OIDC providers. */
8
+ issuer?: string;
9
+ /** This resource server's audience (`aud`). Required for OIDC providers. */
10
+ audience?: string;
11
+ jwksUrl?: string;
12
+ /** Scopes every token must carry; also advertised as `scopes_supported`. */
13
+ scopes?: string[];
14
+ }
15
+ export interface AuthContext {
16
+ subject: string;
17
+ claims: JWTPayload;
18
+ scopes: string[];
19
+ }
20
+ export interface Verifier {
21
+ verify(token: string): Promise<AuthContext>;
22
+ }
23
+ export declare class AuthConfigError extends Error {
24
+ constructor(message: string);
25
+ }
26
+ export declare class InsufficientScopeError extends Error {
27
+ readonly required: string[];
28
+ constructor(required: string[]);
29
+ }
30
+ /** Scopes granted to a token, from `scope` (space-delimited) or `scp` (array). */
31
+ export declare function grantedScopes(claims: JWTPayload): string[];
32
+ export declare class OidcVerifier implements Verifier {
33
+ private readonly cfg;
34
+ private readonly keys;
35
+ constructor(cfg: AuthConfig, keys?: JWTVerifyGetKey);
36
+ verify(token: string): Promise<AuthContext>;
37
+ }
38
+ /** Throws AuthConfigError for an unknown provider or incomplete OIDC configuration. */
39
+ export declare function buildVerifier(cfg: AuthConfig): Verifier | undefined;
40
+ //# sourceMappingURL=authz.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authz.d.ts","sourceRoot":"","sources":["../../src/server/authz.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5F,mGAAmG;AACnG,eAAO,MAAM,cAAc,YAAI,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAC5F,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAAoD;CAChF;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAAvC,YAAqB,QAAQ,EAAE,MAAM,EAAE,EAA0G;CAClJ;AAKD,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAK1D;AAED,qBAAa,YAAa,YAAW,QAAQ;IAE/B,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,YAA6B,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,EAanE;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAYhD;CACF;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAKnE"}