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

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 +52 -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,57 @@
1
+ import type { SandboxLimits } from './limits.js';
2
+ export interface ExecuteOptions {
3
+ code: string;
4
+ timeoutMs?: number;
5
+ memoryMb?: number;
6
+ bindings?: string[];
7
+ /** Overrides for the runner's byte budgets. */
8
+ limits?: Partial<SandboxLimits>;
9
+ /** Aborts the execution (client cancelled, server shutting down). */
10
+ signal?: AbortSignal;
11
+ }
12
+ export interface ExecuteResult {
13
+ ok: boolean;
14
+ value?: unknown;
15
+ logs: string[];
16
+ error?: {
17
+ name: string;
18
+ message: string;
19
+ status?: number;
20
+ };
21
+ durationMs: number;
22
+ }
23
+ export type SandboxKind = 'isolate' | 'deno' | 'auto';
24
+ export interface SandboxRunner {
25
+ kind: 'isolate' | 'deno' | 'unavailable';
26
+ available(): Promise<boolean>;
27
+ execute(opts: ExecuteOptions, rpc: RpcBridge): Promise<ExecuteResult>;
28
+ }
29
+ export interface RpcCall {
30
+ binding: string;
31
+ path: string[];
32
+ args: unknown[];
33
+ }
34
+ export interface RpcContext {
35
+ /** Aborted when the execution ends; in-flight and queued upstream work must stop. */
36
+ signal?: AbortSignal;
37
+ }
38
+ export interface RpcBridge {
39
+ dispatch(call: RpcCall, ctx?: RpcContext): Promise<{
40
+ ok: boolean;
41
+ value?: unknown;
42
+ error?: {
43
+ name: string;
44
+ message: string;
45
+ status?: number;
46
+ };
47
+ }>;
48
+ }
49
+ /**
50
+ * Attached (non-enumerably) to a result whose sandbox process had not yet exited when the result
51
+ * was returned. Resolves once it has. Callers must not release execution capacity before then.
52
+ */
53
+ export declare const TEARDOWN: unique symbol;
54
+ export type WithTeardown<T> = T & {
55
+ [TEARDOWN]?: Promise<void>;
56
+ };
57
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sandbox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,qEAAqE;IACrE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IACzC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAClJ;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,eAAmC,CAAC;AACzD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Attached (non-enumerably) to a result whose sandbox process had not yet exited when the result
3
+ * was returned. Resolves once it has. Callers must not release execution capacity before then.
4
+ */
5
+ export const TEARDOWN = Symbol('uspto.sandbox.teardown');
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sandbox/types.ts"],"names":[],"mappings":"AA4CA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { type Source, type SourceConfig } from './sources/index.js';
2
+ import type { RpcMethods, SourceMeta } from './sources/source.js';
3
+ export interface Sdk {
4
+ clients: Record<string, object>;
5
+ methods: Readonly<Record<string, RpcMethods>>;
6
+ meta: SourceMeta[];
7
+ registeredNames: string[];
8
+ version: () => string;
9
+ }
10
+ export declare function buildSdk(cfg: SourceConfig): Sdk;
11
+ /** One set of sources serves both the corpus and dispatch, so caches are not duplicated. */
12
+ export declare function sdkFromSources(sources: Source[]): Sdk;
13
+ //# sourceMappingURL=bindings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/sdk/bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9C,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,GAAG,CAE/C;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAcrD"}
@@ -0,0 +1,22 @@
1
+ import { getSources } from './sources/index.js';
2
+ export function buildSdk(cfg) {
3
+ return sdkFromSources(getSources(cfg));
4
+ }
5
+ /** One set of sources serves both the corpus and dispatch, so caches are not duplicated. */
6
+ export function sdkFromSources(sources) {
7
+ const clients = {};
8
+ const methods = Object.create(null);
9
+ for (const s of sources)
10
+ if (s.enabled) {
11
+ clients[s.name] = s.client;
12
+ methods[s.name] = s.methods;
13
+ }
14
+ return {
15
+ clients,
16
+ methods: Object.freeze(methods),
17
+ meta: sources.map(({ name, label, enabled, disabledReason }) => ({ name, label, enabled, disabledReason })),
18
+ registeredNames: sources.map(s => s.name),
19
+ version: () => '0.1.1', // x-release-version
20
+ };
21
+ }
22
+ //# sourceMappingURL=bindings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/sdk/bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkC,MAAM,oBAAoB,CAAC;AAWhF,MAAM,UAAU,QAAQ,CAAC,GAAiB;IACxC,OAAO,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,OAAiB;IAC9C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAA+B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;YAC3B,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QAC9B,CAAC;IACD,OAAO;QACL,OAAO;QACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAC3G,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,oBAAoB;KAC7C,CAAC;AACJ,CAAC"}
@@ -0,0 +1,167 @@
1
+ import { HttpClient } from '../util/httpClient.js';
2
+ /**
3
+ * USPTO Open Data Portal (api.uspto.gov). Every search endpoint accepts the same JSON body;
4
+ * see https://data.uspto.gov/apis/api-syntax-examples.
5
+ */
6
+ export interface OdpFilter {
7
+ name: string;
8
+ value: string | string[];
9
+ }
10
+ export interface OdpRangeFilter {
11
+ field: string;
12
+ valueFrom: string | number;
13
+ valueTo: string | number;
14
+ }
15
+ export interface OdpSort {
16
+ field: string;
17
+ order?: 'asc' | 'desc' | 'Asc' | 'Desc';
18
+ }
19
+ export interface OdpSearch {
20
+ /** Lucene-style query: 'inventionTitle:"machine learning" AND applicationMetaData.filingDate:[2024-01-01 TO 2024-12-31]'. */
21
+ q?: string;
22
+ /** Exact-match filters. Either the API's list form, or a map of field -> value(s). */
23
+ filters?: OdpFilter[] | Record<string, string | string[]>;
24
+ /** Inclusive ranges. Either the API's list form, or a map of field -> [from, to]. */
25
+ rangeFilters?: OdpRangeFilter[] | Record<string, [string | number, string | number]>;
26
+ /** 'field desc', a list of those, or the API's [{ field, order }] form. */
27
+ sort?: string | string[] | OdpSort[];
28
+ /** Return only these fields (dotted paths). Strongly recommended: full records are large. */
29
+ fields?: string[];
30
+ /** Count values of these fields across all matches. */
31
+ facets?: string[];
32
+ pagination?: {
33
+ offset?: number;
34
+ limit?: number;
35
+ };
36
+ /** Shorthand for pagination.offset / pagination.limit. */
37
+ offset?: number;
38
+ limit?: number;
39
+ }
40
+ type Body = Record<string, unknown>;
41
+ /** Normalize the convenience forms into the JSON body every ODP search endpoint accepts. */
42
+ export declare function toSearchBody(input?: OdpSearch | string): Body;
43
+ /**
44
+ * GET-style query params for the endpoints that only accept GET (bulk datasets search).
45
+ * Filters use the API's "field value1,value2" string form.
46
+ */
47
+ export declare function toSearchQuery(input?: OdpSearch | string): Record<string, string | number | undefined>;
48
+ /**
49
+ * Accepts '17/248,024', 'US 17248024', '17248024', and PCT forms ('PCT/US2024/012345',
50
+ * 'PCTUS2024012345'); returns the form the ODP path parameter expects.
51
+ */
52
+ export declare function normalizeApplicationNumber(value: unknown): string;
53
+ /**
54
+ * ODP answers a query with no hits with HTTP 404 and a "No matching records found" body (verified live
55
+ * 2026-11-12) instead of `count: 0`. For searches and list endpoints that is an empty result, not an
56
+ * error; get-by-id keeps NotFound.
57
+ */
58
+ export declare function isNoMatches(err: unknown): boolean;
59
+ /** Office Action (DSAPI, legacy) paging + Lucene/Solr criteria. */
60
+ export interface DsapiParams {
61
+ start?: number;
62
+ rows?: number;
63
+ }
64
+ export declare class OdpClient {
65
+ private readonly http;
66
+ constructor(http: HttpClient);
67
+ private search;
68
+ private list;
69
+ private get;
70
+ private app;
71
+ patents: {
72
+ search: (params?: OdpSearch | string) => Promise<unknown>;
73
+ get: (applicationNumber: string) => Promise<unknown>;
74
+ metaData: (applicationNumber: string) => Promise<unknown>;
75
+ adjustment: (applicationNumber: string) => Promise<unknown>;
76
+ assignment: (applicationNumber: string) => Promise<unknown>;
77
+ attorney: (applicationNumber: string) => Promise<unknown>;
78
+ continuity: (applicationNumber: string) => Promise<unknown>;
79
+ foreignPriority: (applicationNumber: string) => Promise<unknown>;
80
+ transactions: (applicationNumber: string) => Promise<unknown>;
81
+ documents: (applicationNumber: string, opts?: {
82
+ documentCodes?: string | string[];
83
+ officialDateFrom?: string;
84
+ officialDateTo?: string;
85
+ }) => Promise<unknown>;
86
+ associatedDocuments: (applicationNumber: string) => Promise<unknown>;
87
+ /** Resolve a granted patent number (e.g. '11,000,000' or 'US11000000B2') to its application record. */
88
+ byPatentNumber: (patentNumber: string, opts?: {
89
+ fields?: string[];
90
+ }) => Promise<unknown>;
91
+ statusCodes: (params?: {
92
+ q?: string;
93
+ offset?: number;
94
+ limit?: number;
95
+ } | string) => Promise<unknown>;
96
+ };
97
+ ptab: {
98
+ proceedings: {
99
+ search: (params?: OdpSearch | string) => Promise<unknown>;
100
+ get: (trialNumber: string) => Promise<unknown>;
101
+ };
102
+ decisions: {
103
+ search: (params?: OdpSearch | string) => Promise<unknown>;
104
+ get: (documentIdentifier: string) => Promise<unknown>;
105
+ byTrial: (trialNumber: string) => Promise<unknown>;
106
+ };
107
+ documents: {
108
+ search: (params?: OdpSearch | string) => Promise<unknown>;
109
+ get: (documentIdentifier: string) => Promise<unknown>;
110
+ byTrial: (trialNumber: string) => Promise<unknown>;
111
+ };
112
+ appeals: {
113
+ search: (params?: OdpSearch | string) => Promise<unknown>;
114
+ get: (documentIdentifier: string) => Promise<unknown>;
115
+ byAppeal: (appealNumber: string) => Promise<unknown>;
116
+ };
117
+ interferences: {
118
+ search: (params?: OdpSearch | string) => Promise<unknown>;
119
+ get: (documentIdentifier: string) => Promise<unknown>;
120
+ byInterference: (interferenceNumber: string) => Promise<unknown>;
121
+ };
122
+ };
123
+ petitions: {
124
+ search: (params?: OdpSearch | string) => Promise<unknown>;
125
+ /** The record includes documentBag (decision documents with download URLs); verified live. */
126
+ get: (petitionDecisionRecordIdentifier: string) => Promise<unknown>;
127
+ };
128
+ officeActions: {
129
+ search: (params?: OdpSearch | string) => Promise<unknown>;
130
+ get: (officeActionRecordIdentifier: string) => Promise<unknown>;
131
+ /** Full office action text as a string. */
132
+ text: (officeActionRecordIdentifier: string) => Promise<unknown>;
133
+ };
134
+ /** Legacy Office Action APIs (DSAPI): Lucene/Solr `criteria`, `start`/`rows` paging, form-encoded. */
135
+ private dsapi;
136
+ oa: {
137
+ text: {
138
+ search: (criteria?: string, params?: DsapiParams) => Promise<unknown>;
139
+ fields: () => Promise<unknown>;
140
+ };
141
+ citations: {
142
+ search: (criteria?: string, params?: DsapiParams) => Promise<unknown>;
143
+ fields: () => Promise<unknown>;
144
+ };
145
+ rejections: {
146
+ search: (criteria?: string, params?: DsapiParams) => Promise<unknown>;
147
+ fields: () => Promise<unknown>;
148
+ };
149
+ enrichedCitations: {
150
+ search: (criteria?: string, params?: DsapiParams) => Promise<unknown>;
151
+ fields: () => Promise<unknown>;
152
+ };
153
+ };
154
+ bulk: {
155
+ search: (params?: OdpSearch | string) => Promise<unknown>;
156
+ get: (productIdentifier: string, opts?: {
157
+ fileDataFromDate?: string;
158
+ fileDataToDate?: string;
159
+ offset?: number;
160
+ limit?: number;
161
+ includeFiles?: boolean;
162
+ latest?: boolean;
163
+ }) => Promise<unknown>;
164
+ };
165
+ }
166
+ export {};
167
+ //# sourceMappingURL=odp-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"odp-client.d.ts","sourceRoot":"","sources":["../../src/sdk/odp-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,253 @@
1
+ import { HttpError } from '../util/httpClient.js';
2
+ /** Normalize the convenience forms into the JSON body every ODP search endpoint accepts. */
3
+ export function toSearchBody(input = {}) {
4
+ const s = typeof input === 'string' ? { q: input } : (input ?? {});
5
+ if (typeof s !== 'object' || Array.isArray(s))
6
+ throw new TypeError('search params must be an object or a query string');
7
+ const body = {};
8
+ if (s.q !== undefined && s.q !== null && String(s.q).trim())
9
+ body.q = String(s.q);
10
+ if (s.filters) {
11
+ body.filters = Array.isArray(s.filters)
12
+ ? s.filters.map(f => ({ name: f.name, value: Array.isArray(f.value) ? f.value.map(String) : [String(f.value)] }))
13
+ : Object.entries(s.filters).map(([name, v]) => ({ name, value: Array.isArray(v) ? v.map(String) : [String(v)] }));
14
+ }
15
+ if (s.rangeFilters) {
16
+ body.rangeFilters = Array.isArray(s.rangeFilters)
17
+ ? s.rangeFilters.map(r => ({ field: r.field, valueFrom: String(r.valueFrom), valueTo: String(r.valueTo) }))
18
+ : Object.entries(s.rangeFilters).map(([field, [from, to]]) => ({ field, valueFrom: String(from), valueTo: String(to) }));
19
+ }
20
+ if (s.sort) {
21
+ const list = Array.isArray(s.sort) ? s.sort : [s.sort];
22
+ body.sort = list.map(item => {
23
+ if (typeof item === 'string') {
24
+ const [field, order] = item.trim().split(/\s+/);
25
+ return { field, order: (order ?? 'desc').toLowerCase() === 'asc' ? 'asc' : 'desc' };
26
+ }
27
+ return { field: item.field, order: (item.order ?? 'desc').toLowerCase() === 'asc' ? 'asc' : 'desc' };
28
+ });
29
+ }
30
+ if (s.fields?.length)
31
+ body.fields = [...s.fields];
32
+ if (s.facets?.length)
33
+ body.facets = [...s.facets];
34
+ const offset = s.pagination?.offset ?? s.offset;
35
+ const limit = s.pagination?.limit ?? s.limit;
36
+ if (offset !== undefined || limit !== undefined) {
37
+ body.pagination = { offset: offset ?? 0, limit: limit ?? 25 };
38
+ }
39
+ return body;
40
+ }
41
+ /**
42
+ * GET-style query params for the endpoints that only accept GET (bulk datasets search).
43
+ * Filters use the API's "field value1,value2" string form.
44
+ */
45
+ export function toSearchQuery(input = {}) {
46
+ const body = toSearchBody(input);
47
+ const out = {};
48
+ if (body.q)
49
+ out.q = body.q;
50
+ const sort = body.sort;
51
+ if (sort?.length)
52
+ out.sort = sort.map(s => `${s.field} ${s.order.toLowerCase()}`).join(',');
53
+ const page = body.pagination;
54
+ if (page) {
55
+ out.offset = page.offset;
56
+ out.limit = page.limit;
57
+ }
58
+ if (body.facets)
59
+ out.facets = body.facets.join(',');
60
+ if (body.fields)
61
+ out.fields = body.fields.join(',');
62
+ // The GET form documents one "field value1,value2" filter and one "field from:to" range;
63
+ // how several combine is undocumented, so refuse rather than guess.
64
+ const filters = body.filters;
65
+ const ranges = body.rangeFilters;
66
+ if ((filters?.length ?? 0) > 1 || (ranges?.length ?? 0) > 1) {
67
+ throw new TypeError('This endpoint accepts at most one filter and one rangeFilter; express further conditions in q (e.g. "productFrequencyText:WEEKLY AND ...").');
68
+ }
69
+ if (filters?.length)
70
+ out.filters = `${filters[0].name} ${filters[0].value.join(',')}`;
71
+ if (ranges?.length)
72
+ out.rangeFilters = `${ranges[0].field} ${ranges[0].valueFrom}:${ranges[0].valueTo}`;
73
+ return out;
74
+ }
75
+ /**
76
+ * Accepts '17/248,024', 'US 17248024', '17248024', and PCT forms ('PCT/US2024/012345',
77
+ * 'PCTUS2024012345'); returns the form the ODP path parameter expects.
78
+ */
79
+ export function normalizeApplicationNumber(value) {
80
+ if (typeof value !== 'string' && typeof value !== 'number')
81
+ throw new TypeError('applicationNumber must be a string');
82
+ const raw = String(value).trim().toUpperCase();
83
+ const pct = raw.replace(/[\s/,-]/g, '');
84
+ if (pct.startsWith('PCT')) {
85
+ if (!/^PCT[A-Z]{2}\d{4}\d{6}$/.test(pct))
86
+ throw new TypeError(`Unrecognized PCT application number '${value}'`);
87
+ return pct;
88
+ }
89
+ const digits = raw.replace(/^US/, '').replace(/[\s/,.-]/g, '');
90
+ if (!/^\d{6,12}$/.test(digits))
91
+ throw new TypeError(`Unrecognized application number '${value}'. Pass the application number (e.g. '17248024' or '17/248,024'); for a patent or publication number use odp.patents.byPatentNumber or odp.patents.search.`);
92
+ return digits;
93
+ }
94
+ /**
95
+ * Path segment for an identifier (trial/appeal/interference numbers, document and record ids,
96
+ * product ids). Letters, digits, '-', '_' and '.', starting with a letter or digit, so a value can
97
+ * never be a dot segment ('.', '..') or contain a separator that changes the endpoint.
98
+ */
99
+ const ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
100
+ function segment(value, what) {
101
+ if (typeof value !== 'string' && typeof value !== 'number')
102
+ throw new TypeError(`${what} must be a string`);
103
+ const v = String(value).trim();
104
+ if (!ID.test(v))
105
+ throw new TypeError(`Invalid ${what} '${v.slice(0, 50)}': use the identifier exactly as the API returns it (letters, digits, '-', '_', '.').`);
106
+ return v;
107
+ }
108
+ /**
109
+ * ODP answers a query with no hits with HTTP 404 and a "No matching records found" body (verified live
110
+ * 2026-11-12) instead of `count: 0`. For searches and list endpoints that is an empty result, not an
111
+ * error; get-by-id keeps NotFound.
112
+ */
113
+ export function isNoMatches(err) {
114
+ return err instanceof HttpError && err.status === 404 && /no matching records/i.test(err.bodySnippet);
115
+ }
116
+ async function emptyOnNoMatches(bag, run) {
117
+ try {
118
+ return await run();
119
+ }
120
+ catch (err) {
121
+ if (isNoMatches(err))
122
+ return { count: 0, [bag]: [] };
123
+ throw err;
124
+ }
125
+ }
126
+ export class OdpClient {
127
+ http;
128
+ constructor(http) {
129
+ this.http = http;
130
+ }
131
+ search(path, bag, params) {
132
+ const body = toSearchBody(params);
133
+ return emptyOnNoMatches(bag, () => this.http.call({ method: 'POST', path, body, cacheable: true }));
134
+ }
135
+ list(path, bag) {
136
+ return emptyOnNoMatches(bag, () => this.http.call({ path }));
137
+ }
138
+ get(path, query) {
139
+ return this.http.call({ path, query });
140
+ }
141
+ app(applicationNumber, suffix = '') {
142
+ return this.get(`/api/v1/patent/applications/${normalizeApplicationNumber(applicationNumber)}${suffix}`);
143
+ }
144
+ patents = {
145
+ search: (params) => this.search('/api/v1/patent/applications/search', 'patentFileWrapperDataBag', params),
146
+ get: (applicationNumber) => this.app(applicationNumber),
147
+ metaData: (applicationNumber) => this.app(applicationNumber, '/meta-data'),
148
+ adjustment: (applicationNumber) => this.app(applicationNumber, '/adjustment'),
149
+ assignment: (applicationNumber) => this.app(applicationNumber, '/assignment'),
150
+ attorney: (applicationNumber) => this.app(applicationNumber, '/attorney'),
151
+ continuity: (applicationNumber) => this.app(applicationNumber, '/continuity'),
152
+ foreignPriority: (applicationNumber) => this.app(applicationNumber, '/foreign-priority'),
153
+ transactions: (applicationNumber) => this.app(applicationNumber, '/transactions'),
154
+ documents: (applicationNumber, opts = {}) => this.get(`/api/v1/patent/applications/${normalizeApplicationNumber(applicationNumber)}/documents`, {
155
+ documentCodes: Array.isArray(opts.documentCodes) ? opts.documentCodes.join(',') : opts.documentCodes,
156
+ officialDateFrom: opts.officialDateFrom, officialDateTo: opts.officialDateTo,
157
+ }),
158
+ associatedDocuments: (applicationNumber) => this.app(applicationNumber, '/associated-documents'),
159
+ /** Resolve a granted patent number (e.g. '11,000,000' or 'US11000000B2') to its application record. */
160
+ byPatentNumber: (patentNumber, opts = {}) => {
161
+ if (typeof patentNumber !== 'string' && typeof patentNumber !== 'number')
162
+ throw new TypeError('patentNumber must be a string');
163
+ const n = String(patentNumber).toUpperCase().replace(/^US/, '').replace(/[\s,]/g, '').replace(/[A-Z]\d?$/, '');
164
+ if (!/^(?:[A-Z]{1,2})?\d{4,8}$/.test(n))
165
+ throw new TypeError(`Unrecognized patent number '${patentNumber}'`);
166
+ return this.search('/api/v1/patent/applications/search', 'patentFileWrapperDataBag', {
167
+ q: `applicationMetaData.patentNumber:${n}`, pagination: { offset: 0, limit: 1 },
168
+ ...(opts.fields ? { fields: opts.fields } : {}),
169
+ });
170
+ },
171
+ statusCodes: (params = {}) => {
172
+ const p = typeof params === 'string' ? { q: params } : params;
173
+ const body = { ...(p.q ? { q: p.q } : {}), pagination: { offset: p.offset ?? 0, limit: p.limit ?? 100 } };
174
+ return emptyOnNoMatches('statusCodeBag', () => this.http.call({ method: 'POST', path: '/api/v1/patent/status-codes', cacheable: true, body }));
175
+ },
176
+ };
177
+ ptab = {
178
+ proceedings: {
179
+ search: (params) => this.search('/api/v1/patent/trials/proceedings/search', 'patentTrialProceedingDataBag', params),
180
+ get: (trialNumber) => this.get(`/api/v1/patent/trials/proceedings/${segment(trialNumber, 'trialNumber')}`),
181
+ },
182
+ decisions: {
183
+ search: (params) => this.search('/api/v1/patent/trials/decisions/search', 'patentTrialDocumentDataBag', params),
184
+ get: (documentIdentifier) => this.get(`/api/v1/patent/trials/decisions/${segment(documentIdentifier, 'documentIdentifier')}`),
185
+ byTrial: (trialNumber) => this.list(`/api/v1/patent/trials/${segment(trialNumber, 'trialNumber')}/decisions`, 'patentTrialDocumentDataBag'),
186
+ },
187
+ documents: {
188
+ search: (params) => this.search('/api/v1/patent/trials/documents/search', 'patentTrialDocumentDataBag', params),
189
+ get: (documentIdentifier) => this.get(`/api/v1/patent/trials/documents/${segment(documentIdentifier, 'documentIdentifier')}`),
190
+ byTrial: (trialNumber) => this.list(`/api/v1/patent/trials/${segment(trialNumber, 'trialNumber')}/documents`, 'patentTrialDocumentDataBag'),
191
+ },
192
+ appeals: {
193
+ search: (params) => this.search('/api/v1/patent/appeals/decisions/search', 'patentAppealDataBag', params),
194
+ get: (documentIdentifier) => this.get(`/api/v1/patent/appeals/decisions/${segment(documentIdentifier, 'documentIdentifier')}`),
195
+ byAppeal: (appealNumber) => this.list(`/api/v1/patent/appeals/${segment(appealNumber, 'appealNumber')}/decisions`, 'patentAppealDataBag'),
196
+ },
197
+ interferences: {
198
+ search: (params) => this.search('/api/v1/patent/interferences/decisions/search', 'patentInterferenceDataBag', params),
199
+ get: (documentIdentifier) => this.get(`/api/v1/patent/interferences/decisions/${segment(documentIdentifier, 'documentIdentifier')}`),
200
+ byInterference: (interferenceNumber) => this.list(`/api/v1/patent/interferences/${segment(interferenceNumber, 'interferenceNumber')}/decisions`, 'patentInterferenceDataBag'),
201
+ },
202
+ };
203
+ petitions = {
204
+ search: (params) => this.search('/api/v1/petition/decisions/search', 'petitionDecisionDataBag', params),
205
+ /** The record includes documentBag (decision documents with download URLs); verified live. */
206
+ get: (petitionDecisionRecordIdentifier) => this.get(`/api/v1/petition/decisions/${segment(petitionDecisionRecordIdentifier, 'petitionDecisionRecordIdentifier')}`),
207
+ };
208
+ officeActions = {
209
+ search: (params) => this.search('/api/v1/patent/office-action/search', 'officeActionDataBag', params),
210
+ get: (officeActionRecordIdentifier) => this.get(`/api/v1/patent/office-action/${segment(officeActionRecordIdentifier, 'officeActionRecordIdentifier')}`),
211
+ /** Full office action text as a string. */
212
+ text: (officeActionRecordIdentifier) => this.http.call({
213
+ path: `/api/v1/patent/office-action/${segment(officeActionRecordIdentifier, 'officeActionRecordIdentifier')}/download/officeActionText`,
214
+ accept: 'text',
215
+ }),
216
+ };
217
+ /** Legacy Office Action APIs (DSAPI): Lucene/Solr `criteria`, `start`/`rows` paging, form-encoded. */
218
+ dsapi(dataset) {
219
+ return {
220
+ search: (criteria = '*:*', params = {}) => {
221
+ if (typeof criteria !== 'string')
222
+ throw new TypeError('criteria must be a Lucene query string');
223
+ const rows = params.rows ?? 25;
224
+ if (!Number.isInteger(rows) || rows < 1 || rows > 1000)
225
+ throw new RangeError('rows must be an integer between 1 and 1000');
226
+ return this.http.call({
227
+ method: 'POST', path: `/api/v1/patent/oa/${dataset}/records`, cacheable: true,
228
+ form: { criteria: criteria.trim() || '*:*', start: params.start ?? 0, rows },
229
+ });
230
+ },
231
+ fields: () => this.get(`/api/v1/patent/oa/${dataset}/fields`),
232
+ };
233
+ }
234
+ oa = {
235
+ text: this.dsapi('oa_actions/v1'),
236
+ citations: this.dsapi('oa_citations/v2'),
237
+ rejections: this.dsapi('oa_rejections/v2'),
238
+ enrichedCitations: this.dsapi('enriched_cited_reference_metadata/v3'),
239
+ };
240
+ bulk = {
241
+ search: (params) => {
242
+ const query = toSearchQuery(params);
243
+ return emptyOnNoMatches('bulkDataProductBag', () => this.get('/api/v1/datasets/products/search', query));
244
+ },
245
+ get: (productIdentifier, opts = {}) => this.get(`/api/v1/datasets/products/${segment(productIdentifier, 'productIdentifier')}`, {
246
+ fileDataFromDate: opts.fileDataFromDate, fileDataToDate: opts.fileDataToDate,
247
+ offset: opts.offset, limit: opts.limit,
248
+ includeFiles: opts.includeFiles === undefined ? undefined : String(opts.includeFiles),
249
+ latest: opts.latest === undefined ? undefined : String(opts.latest),
250
+ }),
251
+ };
252
+ }
253
+ //# sourceMappingURL=odp-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"odp-client.js","sourceRoot":"","sources":["../../src/sdk/odp-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { RpcMethods, SourceMeta } from './sources/source.js';
2
+ export interface RpcRequest {
3
+ binding: string;
4
+ path: string[];
5
+ args: unknown[];
6
+ }
7
+ export interface RpcResponse {
8
+ ok: boolean;
9
+ value?: unknown;
10
+ error?: {
11
+ name: string;
12
+ message: string;
13
+ status?: number;
14
+ };
15
+ }
16
+ export interface DispatchRegistry {
17
+ methods: Readonly<Record<string, RpcMethods>>;
18
+ meta: SourceMeta[];
19
+ }
20
+ export declare function dispatch(reg: DispatchRegistry, req: RpcRequest): Promise<RpcResponse>;
21
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/sdk/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9C,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA6B3F"}
@@ -0,0 +1,32 @@
1
+ export async function dispatch(reg, req) {
2
+ // Validate the RPC envelope independently of AST preflight. Dotted keys inside
3
+ // a single path segment must not alias an explicitly registered method.
4
+ if (!req || typeof req.binding !== 'string' || !Array.isArray(req.path)
5
+ || req.path.length === 0 || !req.path.every(p => typeof p === 'string' && /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(p))
6
+ || !Array.isArray(req.args)) {
7
+ return { ok: false, error: { name: 'TypeError', message: 'Invalid SDK call' } };
8
+ }
9
+ const methods = Object.getOwnPropertyDescriptor(reg.methods, req.binding)?.value;
10
+ if (!methods) {
11
+ const m = reg.meta.find(x => x.name === req.binding);
12
+ if (m && !m.enabled) {
13
+ return { ok: false, error: { name: 'SourceUnavailable', message: m.disabledReason ?? `${m.label} is unavailable` } };
14
+ }
15
+ return { ok: false, error: { name: 'TypeError', message: `Cannot resolve binding '${req.binding}'` } };
16
+ }
17
+ try {
18
+ // Resolve only an own data property in the source's explicit registry.
19
+ // Never walk the client object: TypeScript `private` is not a runtime boundary.
20
+ const method = Object.getOwnPropertyDescriptor(methods, req.path.join('.'))?.value;
21
+ if (typeof method !== 'function') {
22
+ return { ok: false, error: { name: 'TypeError', message: `${req.binding}.${req.path.join('.')} is not a function` } };
23
+ }
24
+ const value = await method(...req.args);
25
+ return { ok: true, value };
26
+ }
27
+ catch (err) {
28
+ const e = err;
29
+ return { ok: false, error: { name: e.name ?? 'Error', message: e.message ?? String(err), status: e.status } };
30
+ }
31
+ }
32
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/sdk/runtime.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAqB,EAAE,GAAe;IACnE,+EAA+E;IAC/E,wEAAwE;IACxE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;WAClE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;WAC5G,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,KAA+B,CAAC;IAC3G,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC,KAAK,iBAAiB,EAAE,EAAE,CAAC;QACvH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,2BAA2B,GAAG,CAAC,OAAO,GAAG,EAAE,EAAE,CAAC;IACzG,CAAC;IACD,IAAI,CAAC;QACH,uEAAuE;QACvE,gFAAgF;QAChF,MAAM,MAAM,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;QACnF,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC;QACxH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA2D,CAAC;QACtE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAChH,CAAC;AACH,CAAC"}