raffel 0.2.3 → 1.0.0-next.f81d4db

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 (590) hide show
  1. package/dist/adapters/grpc.d.ts.map +1 -1
  2. package/dist/adapters/grpc.js +1 -15
  3. package/dist/adapters/grpc.js.map +1 -1
  4. package/dist/adapters/http.d.ts +6 -0
  5. package/dist/adapters/http.d.ts.map +1 -1
  6. package/dist/adapters/http.js +53 -86
  7. package/dist/adapters/http.js.map +1 -1
  8. package/dist/adapters/index.d.ts +0 -2
  9. package/dist/adapters/index.d.ts.map +1 -1
  10. package/dist/adapters/index.js +0 -2
  11. package/dist/adapters/index.js.map +1 -1
  12. package/dist/adapters/tcp.d.ts +16 -0
  13. package/dist/adapters/tcp.d.ts.map +1 -1
  14. package/dist/adapters/tcp.js +85 -34
  15. package/dist/adapters/tcp.js.map +1 -1
  16. package/dist/adapters/websocket.d.ts.map +1 -1
  17. package/dist/adapters/websocket.js +1 -14
  18. package/dist/adapters/websocket.js.map +1 -1
  19. package/dist/cache/drivers/index.d.ts +0 -1
  20. package/dist/cache/drivers/index.d.ts.map +1 -1
  21. package/dist/cache/drivers/index.js +0 -1
  22. package/dist/cache/drivers/index.js.map +1 -1
  23. package/dist/cache/factory.d.ts +2 -9
  24. package/dist/cache/factory.d.ts.map +1 -1
  25. package/dist/cache/factory.js +1 -19
  26. package/dist/cache/factory.js.map +1 -1
  27. package/dist/cache/index.d.ts +2 -7
  28. package/dist/cache/index.d.ts.map +1 -1
  29. package/dist/cache/index.js +1 -6
  30. package/dist/cache/index.js.map +1 -1
  31. package/dist/cache/types.d.ts +1 -32
  32. package/dist/cache/types.d.ts.map +1 -1
  33. package/dist/core/event-delivery.d.ts.map +1 -1
  34. package/dist/core/event-delivery.js +5 -3
  35. package/dist/core/event-delivery.js.map +1 -1
  36. package/dist/core/index.d.ts +1 -1
  37. package/dist/core/index.d.ts.map +1 -1
  38. package/dist/core/registry.d.ts +3 -3
  39. package/dist/core/registry.d.ts.map +1 -1
  40. package/dist/core/registry.js +30 -8
  41. package/dist/core/registry.js.map +1 -1
  42. package/dist/core/router.d.ts.map +1 -1
  43. package/dist/core/router.js +5 -4
  44. package/dist/core/router.js.map +1 -1
  45. package/dist/docs/generators/code-samples.d.ts +32 -0
  46. package/dist/docs/generators/code-samples.d.ts.map +1 -0
  47. package/dist/docs/generators/code-samples.js +322 -0
  48. package/dist/docs/generators/code-samples.js.map +1 -0
  49. package/dist/docs/generators/errors-types.d.ts +2 -2
  50. package/dist/docs/generators/errors-types.js +2 -2
  51. package/dist/docs/generators/http-generator.d.ts +10 -0
  52. package/dist/docs/generators/http-generator.d.ts.map +1 -1
  53. package/dist/docs/generators/http-generator.js +100 -3
  54. package/dist/docs/generators/http-generator.js.map +1 -1
  55. package/dist/docs/generators/usd-generator.d.ts +31 -1
  56. package/dist/docs/generators/usd-generator.d.ts.map +1 -1
  57. package/dist/docs/generators/usd-generator.js +19 -1
  58. package/dist/docs/generators/usd-generator.js.map +1 -1
  59. package/dist/docs/generators/websocket-generator.d.ts.map +1 -1
  60. package/dist/docs/generators/websocket-generator.js +6 -4
  61. package/dist/docs/generators/websocket-generator.js.map +1 -1
  62. package/dist/docs/ui/html-builder.d.ts.map +1 -1
  63. package/dist/docs/ui/html-builder.js +260 -54
  64. package/dist/docs/ui/html-builder.js.map +1 -1
  65. package/dist/docs/ui/styles.d.ts.map +1 -1
  66. package/dist/docs/ui/styles.js +240 -30
  67. package/dist/docs/ui/styles.js.map +1 -1
  68. package/dist/docs/ui/types.d.ts +15 -1
  69. package/dist/docs/ui/types.d.ts.map +1 -1
  70. package/dist/docs/usd-middleware.d.ts +32 -7
  71. package/dist/docs/usd-middleware.d.ts.map +1 -1
  72. package/dist/docs/usd-middleware.js +5 -1
  73. package/dist/docs/usd-middleware.js.map +1 -1
  74. package/dist/dx/index.d.ts +2 -0
  75. package/dist/dx/index.d.ts.map +1 -1
  76. package/dist/dx/index.js +1 -0
  77. package/dist/dx/index.js.map +1 -1
  78. package/dist/dx/logging/index.d.ts.map +1 -1
  79. package/dist/dx/logging/index.js +5 -3
  80. package/dist/dx/logging/index.js.map +1 -1
  81. package/dist/dx/scenarios.d.ts +26 -0
  82. package/dist/dx/scenarios.d.ts.map +1 -0
  83. package/dist/dx/scenarios.js +109 -0
  84. package/dist/dx/scenarios.js.map +1 -0
  85. package/dist/errors/codes.d.ts +1 -1
  86. package/dist/errors/codes.js +1 -1
  87. package/dist/graphql/adapter.js +1 -1
  88. package/dist/http/index.d.ts +2 -0
  89. package/dist/http/index.d.ts.map +1 -1
  90. package/dist/http/index.js +4 -0
  91. package/dist/http/index.js.map +1 -1
  92. package/dist/http/openapi-ui.d.ts +174 -0
  93. package/dist/http/openapi-ui.d.ts.map +1 -0
  94. package/dist/http/openapi-ui.js +221 -0
  95. package/dist/http/openapi-ui.js.map +1 -0
  96. package/dist/http/serve.d.ts +14 -0
  97. package/dist/http/serve.d.ts.map +1 -1
  98. package/dist/http/serve.js +8 -1
  99. package/dist/http/serve.js.map +1 -1
  100. package/dist/index.d.ts +17 -10
  101. package/dist/index.d.ts.map +1 -1
  102. package/dist/index.js +12 -6
  103. package/dist/index.js.map +1 -1
  104. package/dist/mcp/cli.d.ts +2 -1
  105. package/dist/mcp/cli.d.ts.map +1 -1
  106. package/dist/mcp/cli.js +30 -7
  107. package/dist/mcp/cli.js.map +1 -1
  108. package/dist/mcp/docs/adapters.d.ts.map +1 -1
  109. package/dist/mcp/docs/adapters.js +1 -117
  110. package/dist/mcp/docs/adapters.js.map +1 -1
  111. package/dist/mcp/docs/index.d.ts +0 -1
  112. package/dist/mcp/docs/index.d.ts.map +1 -1
  113. package/dist/mcp/docs/index.js +0 -1
  114. package/dist/mcp/docs/index.js.map +1 -1
  115. package/dist/mcp/docs/interceptors.d.ts.map +1 -1
  116. package/dist/mcp/docs/interceptors.js +272 -1
  117. package/dist/mcp/docs/interceptors.js.map +1 -1
  118. package/dist/mcp/docs/patterns.js +1 -1
  119. package/dist/mcp/prompts/index.d.ts.map +1 -1
  120. package/dist/mcp/prompts/index.js +147 -22
  121. package/dist/mcp/prompts/index.js.map +1 -1
  122. package/dist/mcp/resources/index.d.ts.map +1 -1
  123. package/dist/mcp/resources/index.js +508 -10
  124. package/dist/mcp/resources/index.js.map +1 -1
  125. package/dist/mcp/server.js +1 -1
  126. package/dist/mcp/server.js.map +1 -1
  127. package/dist/mcp/tools/definitions.d.ts +2 -0
  128. package/dist/mcp/tools/definitions.d.ts.map +1 -1
  129. package/dist/mcp/tools/definitions.js +149 -1
  130. package/dist/mcp/tools/definitions.js.map +1 -1
  131. package/dist/mcp/tools/handlers.d.ts.map +1 -1
  132. package/dist/mcp/tools/handlers.js +828 -44
  133. package/dist/mcp/tools/handlers.js.map +1 -1
  134. package/dist/mcp/types.d.ts +1 -1
  135. package/dist/mcp/types.d.ts.map +1 -1
  136. package/dist/metrics/interceptor.d.ts.map +1 -1
  137. package/dist/metrics/interceptor.js +10 -2
  138. package/dist/metrics/interceptor.js.map +1 -1
  139. package/dist/middleware/interceptors/cache.d.ts +1 -1
  140. package/dist/middleware/interceptors/cache.d.ts.map +1 -1
  141. package/dist/middleware/interceptors/cache.js +4 -2
  142. package/dist/middleware/interceptors/cache.js.map +1 -1
  143. package/dist/middleware/interceptors/envelope.d.ts.map +1 -1
  144. package/dist/middleware/interceptors/envelope.js +12 -14
  145. package/dist/middleware/interceptors/envelope.js.map +1 -1
  146. package/dist/middleware/interceptors/logging.d.ts.map +1 -1
  147. package/dist/middleware/interceptors/logging.js +11 -6
  148. package/dist/middleware/interceptors/logging.js.map +1 -1
  149. package/dist/middleware/session/drivers/memory.d.ts +36 -0
  150. package/dist/middleware/session/drivers/memory.d.ts.map +1 -0
  151. package/dist/middleware/session/drivers/memory.js +82 -0
  152. package/dist/middleware/session/drivers/memory.js.map +1 -0
  153. package/dist/middleware/session/drivers/redis.d.ts +58 -0
  154. package/dist/middleware/session/drivers/redis.d.ts.map +1 -0
  155. package/dist/middleware/session/drivers/redis.js +70 -0
  156. package/dist/middleware/session/drivers/redis.js.map +1 -0
  157. package/dist/middleware/session/drivers/s3db.d.ts +65 -0
  158. package/dist/middleware/session/drivers/s3db.d.ts.map +1 -0
  159. package/dist/middleware/session/drivers/s3db.js +98 -0
  160. package/dist/middleware/session/drivers/s3db.js.map +1 -0
  161. package/dist/middleware/session/index.d.ts +47 -0
  162. package/dist/middleware/session/index.d.ts.map +1 -0
  163. package/dist/middleware/session/index.js +46 -0
  164. package/dist/middleware/session/index.js.map +1 -0
  165. package/dist/middleware/session/interceptor.d.ts +42 -0
  166. package/dist/middleware/session/interceptor.d.ts.map +1 -0
  167. package/dist/middleware/session/interceptor.js +264 -0
  168. package/dist/middleware/session/interceptor.js.map +1 -0
  169. package/dist/middleware/session/types.d.ts +116 -0
  170. package/dist/middleware/session/types.d.ts.map +1 -0
  171. package/dist/middleware/session/types.js +9 -0
  172. package/dist/middleware/session/types.js.map +1 -0
  173. package/dist/proxy/connect-tunnel.d.ts +50 -0
  174. package/dist/proxy/connect-tunnel.d.ts.map +1 -0
  175. package/dist/proxy/connect-tunnel.js +163 -0
  176. package/dist/proxy/connect-tunnel.js.map +1 -0
  177. package/dist/proxy/http-forward.d.ts +48 -0
  178. package/dist/proxy/http-forward.d.ts.map +1 -0
  179. package/dist/proxy/http-forward.js +160 -0
  180. package/dist/proxy/http-forward.js.map +1 -0
  181. package/dist/proxy/index.d.ts +19 -0
  182. package/dist/proxy/index.d.ts.map +1 -0
  183. package/dist/proxy/index.js +14 -0
  184. package/dist/proxy/index.js.map +1 -0
  185. package/dist/proxy/socks5.d.ts +22 -0
  186. package/dist/proxy/socks5.d.ts.map +1 -0
  187. package/dist/proxy/socks5.js +307 -0
  188. package/dist/proxy/socks5.js.map +1 -0
  189. package/dist/proxy/transparent.d.ts +40 -0
  190. package/dist/proxy/transparent.d.ts.map +1 -0
  191. package/dist/proxy/transparent.js +144 -0
  192. package/dist/proxy/transparent.js.map +1 -0
  193. package/dist/proxy/types.d.ts +32 -0
  194. package/dist/proxy/types.d.ts.map +1 -0
  195. package/dist/proxy/types.js +5 -0
  196. package/dist/proxy/types.js.map +1 -0
  197. package/dist/proxy/utils/auth.d.ts +31 -0
  198. package/dist/proxy/utils/auth.d.ts.map +1 -0
  199. package/dist/proxy/utils/auth.js +69 -0
  200. package/dist/proxy/utils/auth.js.map +1 -0
  201. package/dist/proxy/utils/hop-headers.d.ts +13 -0
  202. package/dist/proxy/utils/hop-headers.d.ts.map +1 -0
  203. package/dist/proxy/utils/hop-headers.js +38 -0
  204. package/dist/proxy/utils/hop-headers.js.map +1 -0
  205. package/dist/proxy/utils/pipe.d.ts +22 -0
  206. package/dist/proxy/utils/pipe.d.ts.map +1 -0
  207. package/dist/proxy/utils/pipe.js +60 -0
  208. package/dist/proxy/utils/pipe.js.map +1 -0
  209. package/dist/rate-limit/factory.d.ts.map +1 -1
  210. package/dist/rate-limit/factory.js +30 -6
  211. package/dist/rate-limit/factory.js.map +1 -1
  212. package/dist/server/builder/config-preview.d.ts +34 -0
  213. package/dist/server/builder/config-preview.d.ts.map +1 -0
  214. package/dist/server/builder/config-preview.js +95 -0
  215. package/dist/server/builder/config-preview.js.map +1 -0
  216. package/dist/server/builder/lifecycle-utils.d.ts +11 -0
  217. package/dist/server/builder/lifecycle-utils.d.ts.map +1 -0
  218. package/dist/server/builder/lifecycle-utils.js +32 -0
  219. package/dist/server/builder/lifecycle-utils.js.map +1 -0
  220. package/dist/server/builder/lifecycle.d.ts +86 -0
  221. package/dist/server/builder/lifecycle.d.ts.map +1 -0
  222. package/dist/server/builder/lifecycle.js +738 -0
  223. package/dist/server/builder/lifecycle.js.map +1 -0
  224. package/dist/server/builder/single-port-utils.d.ts +27 -0
  225. package/dist/server/builder/single-port-utils.d.ts.map +1 -0
  226. package/dist/server/builder/single-port-utils.js +170 -0
  227. package/dist/server/builder/single-port-utils.js.map +1 -0
  228. package/dist/server/builder.d.ts.map +1 -1
  229. package/dist/server/builder.js +446 -601
  230. package/dist/server/builder.js.map +1 -1
  231. package/dist/server/discovery-bootstrap.d.ts +21 -0
  232. package/dist/server/discovery-bootstrap.d.ts.map +1 -0
  233. package/dist/server/discovery-bootstrap.js +39 -0
  234. package/dist/server/discovery-bootstrap.js.map +1 -0
  235. package/dist/server/errors.d.ts.map +1 -1
  236. package/dist/server/errors.js +1 -33
  237. package/dist/server/errors.js.map +1 -1
  238. package/dist/server/front-door.d.ts +34 -0
  239. package/dist/server/front-door.d.ts.map +1 -0
  240. package/dist/server/front-door.js +238 -0
  241. package/dist/server/front-door.js.map +1 -0
  242. package/dist/server/fs-routes/types.d.ts +6 -0
  243. package/dist/server/fs-routes/types.d.ts.map +1 -1
  244. package/dist/server/handler-builders.d.ts +22 -4
  245. package/dist/server/handler-builders.d.ts.map +1 -1
  246. package/dist/server/handler-builders.js +37 -14
  247. package/dist/server/handler-builders.js.map +1 -1
  248. package/dist/server/index.d.ts +4 -1
  249. package/dist/server/index.d.ts.map +1 -1
  250. package/dist/server/index.js +2 -0
  251. package/dist/server/index.js.map +1 -1
  252. package/dist/server/interceptor-utils.d.ts +8 -0
  253. package/dist/server/interceptor-utils.d.ts.map +1 -0
  254. package/dist/server/interceptor-utils.js +23 -0
  255. package/dist/server/interceptor-utils.js.map +1 -0
  256. package/dist/server/port-binding.d.ts +44 -0
  257. package/dist/server/port-binding.d.ts.map +1 -0
  258. package/dist/server/port-binding.js +94 -0
  259. package/dist/server/port-binding.js.map +1 -0
  260. package/dist/server/protocol-aliases.d.ts +56 -0
  261. package/dist/server/protocol-aliases.d.ts.map +1 -0
  262. package/dist/server/protocol-aliases.js +47 -0
  263. package/dist/server/protocol-aliases.js.map +1 -0
  264. package/dist/server/protocol-config.d.ts +17 -1
  265. package/dist/server/protocol-config.d.ts.map +1 -1
  266. package/dist/server/protocol-config.js +116 -9
  267. package/dist/server/protocol-config.js.map +1 -1
  268. package/dist/server/resource-builder.js +3 -3
  269. package/dist/server/resource-builder.js.map +1 -1
  270. package/dist/server/rest-middleware.d.ts.map +1 -1
  271. package/dist/server/rest-middleware.js +1 -15
  272. package/dist/server/rest-middleware.js.map +1 -1
  273. package/dist/server/router-module.d.ts.map +1 -1
  274. package/dist/server/router-module.js +22 -99
  275. package/dist/server/router-module.js.map +1 -1
  276. package/dist/server/shared-context.d.ts.map +1 -1
  277. package/dist/server/shared-context.js +3 -1
  278. package/dist/server/shared-context.js.map +1 -1
  279. package/dist/server/single-port/dispatcher.d.ts +10 -0
  280. package/dist/server/single-port/dispatcher.d.ts.map +1 -0
  281. package/dist/server/single-port/dispatcher.js +188 -0
  282. package/dist/server/single-port/dispatcher.js.map +1 -0
  283. package/dist/server/single-port/index.d.ts +4 -0
  284. package/dist/server/single-port/index.d.ts.map +1 -0
  285. package/dist/server/single-port/index.js +3 -0
  286. package/dist/server/single-port/index.js.map +1 -0
  287. package/dist/server/single-port/registry.d.ts +19 -0
  288. package/dist/server/single-port/registry.d.ts.map +1 -0
  289. package/dist/server/single-port/registry.js +24 -0
  290. package/dist/server/single-port/registry.js.map +1 -0
  291. package/dist/server/single-port/types.d.ts +46 -0
  292. package/dist/server/single-port/types.d.ts.map +1 -0
  293. package/dist/server/single-port/types.js +2 -0
  294. package/dist/server/single-port/types.js.map +1 -0
  295. package/dist/server/telemetry-bootstrap.d.ts +38 -0
  296. package/dist/server/telemetry-bootstrap.d.ts.map +1 -0
  297. package/dist/server/telemetry-bootstrap.js +115 -0
  298. package/dist/server/telemetry-bootstrap.js.map +1 -0
  299. package/dist/server/types.d.ts +422 -21
  300. package/dist/server/types.d.ts.map +1 -1
  301. package/dist/testing/echo-protection.d.ts +30 -0
  302. package/dist/testing/echo-protection.d.ts.map +1 -0
  303. package/dist/testing/echo-protection.js +158 -0
  304. package/dist/testing/echo-protection.js.map +1 -0
  305. package/dist/testing/index.d.ts +344 -0
  306. package/dist/testing/index.d.ts.map +1 -0
  307. package/dist/testing/index.js +1072 -0
  308. package/dist/testing/index.js.map +1 -0
  309. package/dist/testing/mock-dns-server.d.ts +31 -0
  310. package/dist/testing/mock-dns-server.d.ts.map +1 -0
  311. package/dist/testing/mock-dns-server.js +247 -0
  312. package/dist/testing/mock-dns-server.js.map +1 -0
  313. package/dist/testing/mock-hls-server.d.ts +85 -0
  314. package/dist/testing/mock-hls-server.d.ts.map +1 -0
  315. package/dist/testing/mock-hls-server.js +252 -0
  316. package/dist/testing/mock-hls-server.js.map +1 -0
  317. package/dist/testing/mock-proxy-server.d.ts +78 -0
  318. package/dist/testing/mock-proxy-server.d.ts.map +1 -0
  319. package/dist/testing/mock-proxy-server.js +277 -0
  320. package/dist/testing/mock-proxy-server.js.map +1 -0
  321. package/dist/testing/mock-sse-server.d.ts +56 -0
  322. package/dist/testing/mock-sse-server.d.ts.map +1 -0
  323. package/dist/testing/mock-sse-server.js +206 -0
  324. package/dist/testing/mock-sse-server.js.map +1 -0
  325. package/dist/testing/proxy-certs.d.ts +9 -0
  326. package/dist/testing/proxy-certs.d.ts.map +1 -0
  327. package/dist/testing/proxy-certs.js +2 -0
  328. package/dist/testing/proxy-certs.js.map +1 -0
  329. package/dist/testing/service-suite.d.ts +47 -0
  330. package/dist/testing/service-suite.d.ts.map +1 -0
  331. package/dist/testing/service-suite.js +82 -0
  332. package/dist/testing/service-suite.js.map +1 -0
  333. package/dist/testing/service-types.d.ts +32 -0
  334. package/dist/testing/service-types.d.ts.map +1 -0
  335. package/dist/testing/service-types.js +2 -0
  336. package/dist/testing/service-types.js.map +1 -0
  337. package/dist/ui/core/event-delivery.d.ts.map +1 -1
  338. package/dist/ui/core/index.d.ts +1 -1
  339. package/dist/ui/core/index.d.ts.map +1 -1
  340. package/dist/ui/core/registry.d.ts +3 -3
  341. package/dist/ui/core/registry.d.ts.map +1 -1
  342. package/dist/ui/core/router.d.ts.map +1 -1
  343. package/dist/ui/docs/generators/code-samples.d.ts +32 -0
  344. package/dist/ui/docs/generators/code-samples.d.ts.map +1 -0
  345. package/dist/ui/docs/generators/errors-types.d.ts +2 -2
  346. package/dist/ui/docs/generators/http-generator.d.ts +10 -0
  347. package/dist/ui/docs/generators/http-generator.d.ts.map +1 -1
  348. package/dist/ui/docs/generators/usd-generator.d.ts +31 -1
  349. package/dist/ui/docs/generators/usd-generator.d.ts.map +1 -1
  350. package/dist/ui/docs/generators/websocket-generator.d.ts.map +1 -1
  351. package/dist/ui/docs/ui/html-builder.d.ts.map +1 -1
  352. package/dist/ui/docs/ui/styles.d.ts.map +1 -1
  353. package/dist/ui/docs/ui/types.d.ts +15 -1
  354. package/dist/ui/docs/ui/types.d.ts.map +1 -1
  355. package/dist/ui/docs/usd-middleware.d.ts +32 -7
  356. package/dist/ui/docs/usd-middleware.d.ts.map +1 -1
  357. package/dist/ui/errors/codes.d.ts +1 -1
  358. package/dist/ui/server/fs-routes/types.d.ts +6 -0
  359. package/dist/ui/server/fs-routes/types.d.ts.map +1 -1
  360. package/dist/ui/usd/index.d.ts +1 -1
  361. package/dist/ui/usd/index.d.ts.map +1 -1
  362. package/dist/ui/usd/spec/types.d.ts +91 -0
  363. package/dist/ui/usd/spec/types.d.ts.map +1 -1
  364. package/dist/usd/index.d.ts +1 -1
  365. package/dist/usd/index.d.ts.map +1 -1
  366. package/dist/usd/index.js.map +1 -1
  367. package/dist/usd/spec/types.d.ts +91 -0
  368. package/dist/usd/spec/types.d.ts.map +1 -1
  369. package/dist/usd/spec/types.js.map +1 -1
  370. package/dist/utils/certs.d.ts +30 -0
  371. package/dist/utils/certs.d.ts.map +1 -0
  372. package/dist/utils/certs.js +230 -0
  373. package/dist/utils/certs.js.map +1 -0
  374. package/dist/utils/context-utils.d.ts +11 -0
  375. package/dist/utils/context-utils.d.ts.map +1 -0
  376. package/dist/utils/context-utils.js +24 -0
  377. package/dist/utils/context-utils.js.map +1 -0
  378. package/package.json +11 -2
  379. package/dist/adapters/grpc.int.test.d.ts +0 -5
  380. package/dist/adapters/grpc.int.test.d.ts.map +0 -1
  381. package/dist/adapters/grpc.int.test.js +0 -168
  382. package/dist/adapters/grpc.int.test.js.map +0 -1
  383. package/dist/adapters/http.int.test.d.ts +0 -5
  384. package/dist/adapters/http.int.test.d.ts.map +0 -1
  385. package/dist/adapters/http.int.test.js +0 -396
  386. package/dist/adapters/http.int.test.js.map +0 -1
  387. package/dist/adapters/jsonrpc.int.test.d.ts +0 -5
  388. package/dist/adapters/jsonrpc.int.test.d.ts.map +0 -1
  389. package/dist/adapters/jsonrpc.int.test.js +0 -640
  390. package/dist/adapters/jsonrpc.int.test.js.map +0 -1
  391. package/dist/adapters/s3db/adapter.d.ts +0 -105
  392. package/dist/adapters/s3db/adapter.d.ts.map +0 -1
  393. package/dist/adapters/s3db/adapter.js +0 -536
  394. package/dist/adapters/s3db/adapter.js.map +0 -1
  395. package/dist/adapters/s3db/index.d.ts +0 -20
  396. package/dist/adapters/s3db/index.d.ts.map +0 -1
  397. package/dist/adapters/s3db/index.js +0 -25
  398. package/dist/adapters/s3db/index.js.map +0 -1
  399. package/dist/adapters/s3db/s3db.int.test.d.ts +0 -5
  400. package/dist/adapters/s3db/s3db.int.test.d.ts.map +0 -1
  401. package/dist/adapters/s3db/s3db.int.test.js +0 -472
  402. package/dist/adapters/s3db/s3db.int.test.js.map +0 -1
  403. package/dist/adapters/s3db/types.d.ts +0 -277
  404. package/dist/adapters/s3db/types.d.ts.map +0 -1
  405. package/dist/adapters/s3db/types.js +0 -7
  406. package/dist/adapters/s3db/types.js.map +0 -1
  407. package/dist/adapters/s3db/utils/etag.d.ts +0 -65
  408. package/dist/adapters/s3db/utils/etag.d.ts.map +0 -1
  409. package/dist/adapters/s3db/utils/etag.js +0 -99
  410. package/dist/adapters/s3db/utils/etag.js.map +0 -1
  411. package/dist/adapters/s3db/utils/guards.d.ts +0 -121
  412. package/dist/adapters/s3db/utils/guards.d.ts.map +0 -1
  413. package/dist/adapters/s3db/utils/guards.js +0 -169
  414. package/dist/adapters/s3db/utils/guards.js.map +0 -1
  415. package/dist/adapters/s3db/utils/index.d.ts +0 -9
  416. package/dist/adapters/s3db/utils/index.d.ts.map +0 -1
  417. package/dist/adapters/s3db/utils/index.js +0 -10
  418. package/dist/adapters/s3db/utils/index.js.map +0 -1
  419. package/dist/adapters/s3db/utils/populate.d.ts +0 -89
  420. package/dist/adapters/s3db/utils/populate.d.ts.map +0 -1
  421. package/dist/adapters/s3db/utils/populate.js +0 -165
  422. package/dist/adapters/s3db/utils/populate.js.map +0 -1
  423. package/dist/adapters/tcp.int.test.d.ts +0 -5
  424. package/dist/adapters/tcp.int.test.d.ts.map +0 -1
  425. package/dist/adapters/tcp.int.test.js +0 -379
  426. package/dist/adapters/tcp.int.test.js.map +0 -1
  427. package/dist/adapters/udp.int.test.d.ts +0 -5
  428. package/dist/adapters/udp.int.test.d.ts.map +0 -1
  429. package/dist/adapters/udp.int.test.js +0 -397
  430. package/dist/adapters/udp.int.test.js.map +0 -1
  431. package/dist/adapters/websocket.int.test.d.ts +0 -5
  432. package/dist/adapters/websocket.int.test.d.ts.map +0 -1
  433. package/dist/adapters/websocket.int.test.js +0 -383
  434. package/dist/adapters/websocket.int.test.js.map +0 -1
  435. package/dist/cache/drivers/memory.int.test.d.ts +0 -5
  436. package/dist/cache/drivers/memory.int.test.d.ts.map +0 -1
  437. package/dist/cache/drivers/memory.int.test.js +0 -241
  438. package/dist/cache/drivers/memory.int.test.js.map +0 -1
  439. package/dist/cache/drivers/s3db.d.ts +0 -78
  440. package/dist/cache/drivers/s3db.d.ts.map +0 -1
  441. package/dist/cache/drivers/s3db.js +0 -216
  442. package/dist/cache/drivers/s3db.js.map +0 -1
  443. package/dist/channels/channel-manager.int.test.d.ts +0 -5
  444. package/dist/channels/channel-manager.int.test.d.ts.map +0 -1
  445. package/dist/channels/channel-manager.int.test.js +0 -378
  446. package/dist/channels/channel-manager.int.test.js.map +0 -1
  447. package/dist/core/ctx-call.int.test.d.ts +0 -7
  448. package/dist/core/ctx-call.int.test.d.ts.map +0 -1
  449. package/dist/core/ctx-call.int.test.js +0 -263
  450. package/dist/core/ctx-call.int.test.js.map +0 -1
  451. package/dist/core/registry.unit.test.d.ts +0 -2
  452. package/dist/core/registry.unit.test.d.ts.map +0 -1
  453. package/dist/core/registry.unit.test.js +0 -133
  454. package/dist/core/registry.unit.test.js.map +0 -1
  455. package/dist/core/router.int.test.d.ts +0 -2
  456. package/dist/core/router.int.test.d.ts.map +0 -1
  457. package/dist/core/router.int.test.js +0 -368
  458. package/dist/core/router.int.test.js.map +0 -1
  459. package/dist/docs/generators/generators.int.test.d.ts +0 -2
  460. package/dist/docs/generators/generators.int.test.d.ts.map +0 -1
  461. package/dist/docs/generators/generators.int.test.js +0 -105
  462. package/dist/docs/generators/generators.int.test.js.map +0 -1
  463. package/dist/docs/openapi/generator.int.test.d.ts +0 -5
  464. package/dist/docs/openapi/generator.int.test.d.ts.map +0 -1
  465. package/dist/docs/openapi/generator.int.test.js +0 -260
  466. package/dist/docs/openapi/generator.int.test.js.map +0 -1
  467. package/dist/dx/health/health.int.test.d.ts +0 -5
  468. package/dist/dx/health/health.int.test.d.ts.map +0 -1
  469. package/dist/dx/health/health.int.test.js +0 -249
  470. package/dist/dx/health/health.int.test.js.map +0 -1
  471. package/dist/dx/logging/http-logging.int.test.d.ts +0 -5
  472. package/dist/dx/logging/http-logging.int.test.d.ts.map +0 -1
  473. package/dist/dx/logging/http-logging.int.test.js +0 -319
  474. package/dist/dx/logging/http-logging.int.test.js.map +0 -1
  475. package/dist/errors/factories.unit.test.d.ts +0 -7
  476. package/dist/errors/factories.unit.test.d.ts.map +0 -1
  477. package/dist/errors/factories.unit.test.js +0 -358
  478. package/dist/errors/factories.unit.test.js.map +0 -1
  479. package/dist/graphql/graphql.int.test.d.ts +0 -10
  480. package/dist/graphql/graphql.int.test.d.ts.map +0 -1
  481. package/dist/graphql/graphql.int.test.js +0 -698
  482. package/dist/graphql/graphql.int.test.js.map +0 -1
  483. package/dist/graphql/schema-generator.int.test.d.ts +0 -5
  484. package/dist/graphql/schema-generator.int.test.d.ts.map +0 -1
  485. package/dist/graphql/schema-generator.int.test.js +0 -51
  486. package/dist/graphql/schema-generator.int.test.js.map +0 -1
  487. package/dist/http/http.int.test.d.ts +0 -7
  488. package/dist/http/http.int.test.d.ts.map +0 -1
  489. package/dist/http/http.int.test.js +0 -605
  490. package/dist/http/http.int.test.js.map +0 -1
  491. package/dist/http/session-redis.int.test.d.ts +0 -8
  492. package/dist/http/session-redis.int.test.d.ts.map +0 -1
  493. package/dist/http/session-redis.int.test.js +0 -492
  494. package/dist/http/session-redis.int.test.js.map +0 -1
  495. package/dist/metrics/metrics.int.test.d.ts +0 -5
  496. package/dist/metrics/metrics.int.test.d.ts.map +0 -1
  497. package/dist/metrics/metrics.int.test.js +0 -288
  498. package/dist/metrics/metrics.int.test.js.map +0 -1
  499. package/dist/middleware/auth/oauth2.int.test.d.ts +0 -2
  500. package/dist/middleware/auth/oauth2.int.test.d.ts.map +0 -1
  501. package/dist/middleware/auth/oauth2.int.test.js +0 -714
  502. package/dist/middleware/auth/oauth2.int.test.js.map +0 -1
  503. package/dist/middleware/auth.int.test.d.ts +0 -5
  504. package/dist/middleware/auth.int.test.d.ts.map +0 -1
  505. package/dist/middleware/auth.int.test.js +0 -366
  506. package/dist/middleware/auth.int.test.js.map +0 -1
  507. package/dist/middleware/compose.int.test.d.ts +0 -7
  508. package/dist/middleware/compose.int.test.d.ts.map +0 -1
  509. package/dist/middleware/compose.int.test.js +0 -238
  510. package/dist/middleware/compose.int.test.js.map +0 -1
  511. package/dist/middleware/interceptors/bulkhead.int.test.d.ts +0 -5
  512. package/dist/middleware/interceptors/bulkhead.int.test.d.ts.map +0 -1
  513. package/dist/middleware/interceptors/bulkhead.int.test.js +0 -263
  514. package/dist/middleware/interceptors/bulkhead.int.test.js.map +0 -1
  515. package/dist/middleware/interceptors/cache.int.test.d.ts +0 -5
  516. package/dist/middleware/interceptors/cache.int.test.d.ts.map +0 -1
  517. package/dist/middleware/interceptors/cache.int.test.js +0 -470
  518. package/dist/middleware/interceptors/cache.int.test.js.map +0 -1
  519. package/dist/middleware/interceptors/circuit-breaker.int.test.d.ts +0 -5
  520. package/dist/middleware/interceptors/circuit-breaker.int.test.d.ts.map +0 -1
  521. package/dist/middleware/interceptors/circuit-breaker.int.test.js +0 -253
  522. package/dist/middleware/interceptors/circuit-breaker.int.test.js.map +0 -1
  523. package/dist/middleware/interceptors/envelope.int.test.d.ts +0 -5
  524. package/dist/middleware/interceptors/envelope.int.test.d.ts.map +0 -1
  525. package/dist/middleware/interceptors/envelope.int.test.js +0 -409
  526. package/dist/middleware/interceptors/envelope.int.test.js.map +0 -1
  527. package/dist/middleware/interceptors/fallback.int.test.d.ts +0 -5
  528. package/dist/middleware/interceptors/fallback.int.test.d.ts.map +0 -1
  529. package/dist/middleware/interceptors/fallback.int.test.js +0 -211
  530. package/dist/middleware/interceptors/fallback.int.test.js.map +0 -1
  531. package/dist/middleware/interceptors/logging.int.test.d.ts +0 -5
  532. package/dist/middleware/interceptors/logging.int.test.d.ts.map +0 -1
  533. package/dist/middleware/interceptors/logging.int.test.js +0 -144
  534. package/dist/middleware/interceptors/logging.int.test.js.map +0 -1
  535. package/dist/middleware/interceptors/rate-limit.int.test.d.ts +0 -5
  536. package/dist/middleware/interceptors/rate-limit.int.test.d.ts.map +0 -1
  537. package/dist/middleware/interceptors/rate-limit.int.test.js +0 -221
  538. package/dist/middleware/interceptors/rate-limit.int.test.js.map +0 -1
  539. package/dist/middleware/interceptors/request-id.int.test.d.ts +0 -5
  540. package/dist/middleware/interceptors/request-id.int.test.d.ts.map +0 -1
  541. package/dist/middleware/interceptors/request-id.int.test.js +0 -136
  542. package/dist/middleware/interceptors/request-id.int.test.js.map +0 -1
  543. package/dist/middleware/interceptors/retry.int.test.d.ts +0 -5
  544. package/dist/middleware/interceptors/retry.int.test.d.ts.map +0 -1
  545. package/dist/middleware/interceptors/retry.int.test.js +0 -534
  546. package/dist/middleware/interceptors/retry.int.test.js.map +0 -1
  547. package/dist/middleware/interceptors/timeout.int.test.d.ts +0 -5
  548. package/dist/middleware/interceptors/timeout.int.test.d.ts.map +0 -1
  549. package/dist/middleware/interceptors/timeout.int.test.js +0 -228
  550. package/dist/middleware/interceptors/timeout.int.test.js.map +0 -1
  551. package/dist/rate-limit/drivers/drivers.int.test.d.ts +0 -7
  552. package/dist/rate-limit/drivers/drivers.int.test.d.ts.map +0 -1
  553. package/dist/rate-limit/drivers/drivers.int.test.js +0 -466
  554. package/dist/rate-limit/drivers/drivers.int.test.js.map +0 -1
  555. package/dist/server/builder.int.test.d.ts +0 -7
  556. package/dist/server/builder.int.test.d.ts.map +0 -1
  557. package/dist/server/builder.int.test.js +0 -455
  558. package/dist/server/builder.int.test.js.map +0 -1
  559. package/dist/server/fs-routes/loader.int.test.d.ts +0 -5
  560. package/dist/server/fs-routes/loader.int.test.d.ts.map +0 -1
  561. package/dist/server/fs-routes/loader.int.test.js +0 -48
  562. package/dist/server/fs-routes/loader.int.test.js.map +0 -1
  563. package/dist/server/hooks.int.test.d.ts +0 -7
  564. package/dist/server/hooks.int.test.d.ts.map +0 -1
  565. package/dist/server/hooks.int.test.js +0 -564
  566. package/dist/server/hooks.int.test.js.map +0 -1
  567. package/dist/server/route-discovery.int.test.d.ts +0 -5
  568. package/dist/server/route-discovery.int.test.d.ts.map +0 -1
  569. package/dist/server/route-discovery.int.test.js +0 -49
  570. package/dist/server/route-discovery.int.test.js.map +0 -1
  571. package/dist/stream/raffel-stream.int.test.d.ts +0 -2
  572. package/dist/stream/raffel-stream.int.test.d.ts.map +0 -1
  573. package/dist/stream/raffel-stream.int.test.js +0 -265
  574. package/dist/stream/raffel-stream.int.test.js.map +0 -1
  575. package/dist/tracing/tracing.int.test.d.ts +0 -5
  576. package/dist/tracing/tracing.int.test.d.ts.map +0 -1
  577. package/dist/tracing/tracing.int.test.js +0 -412
  578. package/dist/tracing/tracing.int.test.js.map +0 -1
  579. package/dist/usd/usd.int.test.d.ts +0 -10
  580. package/dist/usd/usd.int.test.d.ts.map +0 -1
  581. package/dist/usd/usd.int.test.js +0 -719
  582. package/dist/usd/usd.int.test.js.map +0 -1
  583. package/dist/validation/multi-validator.int.test.d.ts +0 -7
  584. package/dist/validation/multi-validator.int.test.d.ts.map +0 -1
  585. package/dist/validation/multi-validator.int.test.js +0 -808
  586. package/dist/validation/multi-validator.int.test.js.map +0 -1
  587. package/dist/validation/schema.int.test.d.ts +0 -5
  588. package/dist/validation/schema.int.test.d.ts.map +0 -1
  589. package/dist/validation/schema.int.test.js +0 -340
  590. package/dist/validation/schema.int.test.js.map +0 -1
@@ -0,0 +1,48 @@
1
+ /**
2
+ * HTTP Forward Proxy
3
+ *
4
+ * Attaches to an existing http.Server — does not create its own net.Server.
5
+ * Handles plain HTTP proxy requests (absolute-form URL).
6
+ *
7
+ * Usage:
8
+ * const proxy = createHttpForwardProxy({ auth: { credentials: { username, password } } })
9
+ * proxy.attachTo(httpServer)
10
+ */
11
+ import { type IncomingMessage, type ServerResponse, type Server as HttpServer } from 'node:http';
12
+ import type { ProxyAuth, ProxyStats } from './types.js';
13
+ export interface ForwardProxyRequest {
14
+ method: string;
15
+ url: string;
16
+ headers: Record<string, string>;
17
+ body: Buffer;
18
+ }
19
+ export interface ForwardProxyResponse {
20
+ statusCode: number;
21
+ statusMessage: string;
22
+ headers: Record<string, string>;
23
+ body: Buffer;
24
+ }
25
+ export interface HttpForwardProxyOptions {
26
+ auth?: ProxyAuth;
27
+ /** Upstream request timeout in ms. Default: 30_000 */
28
+ timeout?: number;
29
+ /** Additional headers to strip from proxied requests */
30
+ stripHeaders?: string[];
31
+ /** Max request body size in bytes. Default: 10MB */
32
+ maxBodySize?: number;
33
+ /** Hook to inspect/modify outgoing request. Return null to block. */
34
+ onRequest?: (req: ForwardProxyRequest) => ForwardProxyRequest | null | Promise<ForwardProxyRequest | null>;
35
+ /** Hook to inspect/modify upstream response. */
36
+ onResponse?: (res: ForwardProxyResponse) => ForwardProxyResponse | Promise<ForwardProxyResponse>;
37
+ }
38
+ export interface HttpForwardProxy {
39
+ /** Raw request handler — attach manually or use attachTo(). */
40
+ requestHandler(req: IncomingMessage, res: ServerResponse): void;
41
+ /** Attach this proxy's request handler to an http.Server. */
42
+ attachTo(server: HttpServer): void;
43
+ /** Detach this proxy's request handler from an http.Server. */
44
+ detachFrom(server: HttpServer): void;
45
+ readonly stats: ProxyStats;
46
+ }
47
+ export declare function createHttpForwardProxy(options?: HttpForwardProxyOptions): HttpForwardProxy;
48
+ //# sourceMappingURL=http-forward.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-forward.d.ts","sourceRoot":"","sources":["../../src/proxy/http-forward.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,MAAM,IAAI,UAAU,EAC1B,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAIvD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,CACV,GAAG,EAAE,mBAAmB,KACrB,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;IACrE,gDAAgD;IAChD,UAAU,CAAC,EAAE,CACX,GAAG,EAAE,oBAAoB,KACtB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/D,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAClC,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B;AAYD,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAmK9F"}
@@ -0,0 +1,160 @@
1
+ /**
2
+ * HTTP Forward Proxy
3
+ *
4
+ * Attaches to an existing http.Server — does not create its own net.Server.
5
+ * Handles plain HTTP proxy requests (absolute-form URL).
6
+ *
7
+ * Usage:
8
+ * const proxy = createHttpForwardProxy({ auth: { credentials: { username, password } } })
9
+ * proxy.attachTo(httpServer)
10
+ */
11
+ import { request as httpRequest, } from 'node:http';
12
+ import { request as httpsRequest } from 'node:https';
13
+ import { parseBasicProxyAuth, verifyProxyAuth, createProxyStats } from './utils/auth.js';
14
+ import { stripHopByHopHeaders } from './utils/hop-headers.js';
15
+ function flattenHeaders(headers) {
16
+ return Object.fromEntries(Object.entries(headers)
17
+ .filter(([, v]) => v != null)
18
+ .map(([k, v]) => [k, Array.isArray(v) ? v.join(', ') : v]));
19
+ }
20
+ export function createHttpForwardProxy(options = {}) {
21
+ const { auth, timeout = 30_000, stripHeaders, maxBodySize = 10 * 1024 * 1024, onRequest, onResponse, } = options;
22
+ const { mutable, snapshot } = createProxyStats();
23
+ async function handleRequest(req, res) {
24
+ const url = req.url ?? '/';
25
+ // Only handle absolute-form URLs (proxy requests)
26
+ if (!url.startsWith('http://') && !url.startsWith('https://')) {
27
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
28
+ res.end('Bad Request: only absolute URLs are supported');
29
+ return;
30
+ }
31
+ // Proxy auth
32
+ const creds = parseBasicProxyAuth(req.headers['proxy-authorization']);
33
+ const authed = await verifyProxyAuth(auth, creds);
34
+ if (!authed) {
35
+ mutable.authFailures++;
36
+ res.writeHead(407, {
37
+ 'Proxy-Authenticate': 'Basic realm="proxy"',
38
+ 'Content-Type': 'text/plain',
39
+ });
40
+ res.end('Proxy Authentication Required');
41
+ return;
42
+ }
43
+ mutable.connectionsTotal++;
44
+ mutable.connectionsActive++;
45
+ try {
46
+ // Read request body with size limit
47
+ const bodyChunks = [];
48
+ let bodySize = 0;
49
+ await new Promise((resolve, reject) => {
50
+ req.on('data', (chunk) => {
51
+ bodySize += chunk.length;
52
+ if (bodySize > maxBodySize) {
53
+ reject(new Error('BODY_TOO_LARGE'));
54
+ return;
55
+ }
56
+ bodyChunks.push(chunk);
57
+ });
58
+ req.on('end', resolve);
59
+ req.on('error', reject);
60
+ });
61
+ const body = Buffer.concat(bodyChunks);
62
+ mutable.bytesFromClient += body.length;
63
+ let proxyReq = {
64
+ method: req.method ?? 'GET',
65
+ url,
66
+ headers: stripHopByHopHeaders(flattenHeaders(req.headers), stripHeaders),
67
+ body,
68
+ };
69
+ // onRequest hook
70
+ if (onRequest) {
71
+ proxyReq = await onRequest(proxyReq);
72
+ if (proxyReq === null) {
73
+ res.writeHead(403, { 'Content-Type': 'text/plain' });
74
+ res.end('Forbidden');
75
+ return;
76
+ }
77
+ }
78
+ const targetUrl = new URL(proxyReq.url);
79
+ const reqOpts = {
80
+ hostname: targetUrl.hostname,
81
+ port: targetUrl.port ? parseInt(targetUrl.port) : (targetUrl.protocol === 'https:' ? 443 : 80),
82
+ path: targetUrl.pathname + (targetUrl.search ?? ''),
83
+ method: proxyReq.method,
84
+ headers: { ...proxyReq.headers, host: targetUrl.host },
85
+ timeout,
86
+ };
87
+ const doRequest = targetUrl.protocol === 'https:' ? httpsRequest : httpRequest;
88
+ const upstreamRes = await new Promise((resolve, reject) => {
89
+ const upstreamReq = doRequest(reqOpts, (upRes) => {
90
+ const chunks = [];
91
+ upRes.on('data', (chunk) => chunks.push(chunk));
92
+ upRes.on('end', () => {
93
+ const responseBody = Buffer.concat(chunks);
94
+ resolve({
95
+ statusCode: upRes.statusCode ?? 200,
96
+ statusMessage: upRes.statusMessage ?? 'OK',
97
+ headers: flattenHeaders(upRes.headers),
98
+ body: responseBody,
99
+ });
100
+ });
101
+ upRes.on('error', reject);
102
+ });
103
+ upstreamReq.on('error', (err) => {
104
+ const msg = err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND' || err.code === 'ETIMEDOUT'
105
+ ? 'Bad Gateway'
106
+ : 'Bad Gateway';
107
+ reject(Object.assign(new Error(msg), { _isBadGateway: true }));
108
+ });
109
+ upstreamReq.on('timeout', () => {
110
+ upstreamReq.destroy(Object.assign(new Error('Bad Gateway'), { _isBadGateway: true }));
111
+ });
112
+ if (proxyReq.body.length > 0)
113
+ upstreamReq.write(proxyReq.body);
114
+ upstreamReq.end();
115
+ });
116
+ let finalRes = upstreamRes;
117
+ if (onResponse) {
118
+ finalRes = await onResponse(upstreamRes);
119
+ }
120
+ mutable.bytesToClient += finalRes.body.length;
121
+ const outHeaders = stripHopByHopHeaders(finalRes.headers);
122
+ outHeaders['content-length'] = String(finalRes.body.length);
123
+ res.writeHead(finalRes.statusCode, finalRes.statusMessage, outHeaders);
124
+ res.end(finalRes.body);
125
+ }
126
+ catch (err) {
127
+ mutable.connectionsErrored++;
128
+ const e = err;
129
+ if (!res.headersSent) {
130
+ if (e.message === 'BODY_TOO_LARGE') {
131
+ res.writeHead(413, { 'Content-Type': 'text/plain' });
132
+ res.end('Request Entity Too Large');
133
+ }
134
+ else {
135
+ res.writeHead(502, { 'Content-Type': 'text/plain' });
136
+ res.end('Bad Gateway');
137
+ }
138
+ }
139
+ }
140
+ finally {
141
+ mutable.connectionsActive--;
142
+ }
143
+ }
144
+ const handler = (req, res) => {
145
+ void handleRequest(req, res);
146
+ };
147
+ return {
148
+ requestHandler: handler,
149
+ attachTo(server) {
150
+ server.on('request', handler);
151
+ },
152
+ detachFrom(server) {
153
+ server.off('request', handler);
154
+ },
155
+ get stats() {
156
+ return snapshot();
157
+ },
158
+ };
159
+ }
160
+ //# sourceMappingURL=http-forward.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-forward.js","sourceRoot":"","sources":["../../src/proxy/http-forward.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Raffel Proxy Module
3
+ *
4
+ * Four proxy types:
5
+ * - HTTP Forward Proxy (attaches to existing http.Server)
6
+ * - HTTPS CONNECT Tunnel (forward + MITM modes, attaches to existing http.Server)
7
+ * - SOCKS5 Proxy (standalone, RFC 1928 + 1929)
8
+ * - Transparent Proxy (standalone, Linux TPROXY/REDIRECT)
9
+ */
10
+ export { createHttpForwardProxy } from './http-forward.js';
11
+ export type { HttpForwardProxyOptions, HttpForwardProxy, ForwardProxyRequest, ForwardProxyResponse, } from './http-forward.js';
12
+ export { createConnectTunnel } from './connect-tunnel.js';
13
+ export type { ConnectMode, ConnectTunnelOptions, ConnectTunnel, TunnelInfo, } from './connect-tunnel.js';
14
+ export { createSocks5Proxy } from './socks5.js';
15
+ export type { Socks5Options, Socks5ConnectionInfo } from './socks5.js';
16
+ export { createTransparentProxy } from './transparent.js';
17
+ export type { TransparentProxyMode, TransparentProxyOptions, } from './transparent.js';
18
+ export type { ProxyAuth, ProxyCredentials, ProxyStats, ProxyServer } from './types.js';
19
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,UAAU,GACX,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,YAAY,EACV,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Raffel Proxy Module
3
+ *
4
+ * Four proxy types:
5
+ * - HTTP Forward Proxy (attaches to existing http.Server)
6
+ * - HTTPS CONNECT Tunnel (forward + MITM modes, attaches to existing http.Server)
7
+ * - SOCKS5 Proxy (standalone, RFC 1928 + 1929)
8
+ * - Transparent Proxy (standalone, Linux TPROXY/REDIRECT)
9
+ */
10
+ export { createHttpForwardProxy } from './http-forward.js';
11
+ export { createConnectTunnel } from './connect-tunnel.js';
12
+ export { createSocks5Proxy } from './socks5.js';
13
+ export { createTransparentProxy } from './transparent.js';
14
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAQ1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAQzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}
@@ -0,0 +1,22 @@
1
+ import type { ProxyAuth, ProxyServer } from './types.js';
2
+ export interface Socks5ConnectionInfo {
3
+ host: string;
4
+ port: number;
5
+ clientAddress: string;
6
+ atype: 'ipv4' | 'ipv6' | 'hostname';
7
+ }
8
+ export interface Socks5Options {
9
+ port: number;
10
+ host?: string;
11
+ auth?: ProxyAuth;
12
+ /** Upstream connection timeout in ms. Default: 10_000 */
13
+ connectTimeout?: number;
14
+ /** Max concurrent connections. 0 = unlimited. Default: 0 */
15
+ maxConnections?: number;
16
+ onConnect?: (info: Socks5ConnectionInfo) => void;
17
+ onDisconnect?: (info: Socks5ConnectionInfo & {
18
+ reason: string;
19
+ }) => void;
20
+ }
21
+ export declare function createSocks5Proxy(options: Socks5Options): ProxyServer;
22
+ //# sourceMappingURL=socks5.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socks5.d.ts","sourceRoot":"","sources":["../../src/proxy/socks5.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,YAAY,CAAA;AAIpE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAChD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACzE;AAoPD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAiErE"}
@@ -0,0 +1,307 @@
1
+ /**
2
+ * SOCKS5 Proxy (RFC 1928 + RFC 1929)
3
+ *
4
+ * Standalone net.Server. Supports:
5
+ * - No authentication
6
+ * - Username/password authentication (RFC 1929)
7
+ * - CONNECT command only
8
+ * - IPv4 (ATYP 0x01), hostname/SOCKS5h (ATYP 0x03), IPv6 (ATYP 0x04)
9
+ *
10
+ * Usage:
11
+ * const proxy = createSocks5Proxy({ port: 1080 })
12
+ * await proxy.start()
13
+ */
14
+ import { createServer, connect as netConnect } from 'node:net';
15
+ import { verifyProxyAuth, createProxyStats } from './utils/auth.js';
16
+ import { pipeBidirectional } from './utils/pipe.js';
17
+ // SOCKS5 reply codes
18
+ const REP_SUCCESS = 0x00;
19
+ const REP_GENERAL_FAILURE = 0x01;
20
+ const REP_NET_UNREACHABLE = 0x03;
21
+ const REP_HOST_UNREACHABLE = 0x04;
22
+ const REP_CONN_REFUSED = 0x05;
23
+ const REP_CMD_NOT_SUPPORTED = 0x07;
24
+ const REP_ATYP_NOT_SUPPORTED = 0x08;
25
+ function socks5Reply(rep) {
26
+ // VER REP RSV ATYP BND.ADDR(4 bytes) BND.PORT(2 bytes)
27
+ return Buffer.from([0x05, rep, 0x00, 0x01, 0, 0, 0, 0, 0, 0]);
28
+ }
29
+ function mapUpstreamError(err) {
30
+ switch (err.code) {
31
+ case 'ECONNREFUSED':
32
+ return REP_CONN_REFUSED;
33
+ case 'ETIMEDOUT':
34
+ case 'EHOSTUNREACH':
35
+ return REP_HOST_UNREACHABLE;
36
+ case 'ENETUNREACH':
37
+ return REP_NET_UNREACHABLE;
38
+ default:
39
+ return REP_GENERAL_FAILURE;
40
+ }
41
+ }
42
+ function handleSocks5Connection(socket, options, mutable) {
43
+ const { auth, connectTimeout = 10_000, onConnect, onDisconnect } = options;
44
+ // Use ArrayBufferLike generic to allow assignment of Buffer.concat / subarray results
45
+ let buf = Buffer.alloc(0);
46
+ let step = 'auth_selection';
47
+ let suspended = false;
48
+ function onData(chunk) {
49
+ buf = buf.length === 0 ? chunk : Buffer.concat([buf, chunk]);
50
+ if (!suspended)
51
+ process();
52
+ }
53
+ socket.on('data', onData);
54
+ socket.on('error', () => {
55
+ mutable.connectionsErrored++;
56
+ });
57
+ function process() {
58
+ if (step === 'auth_selection')
59
+ processAuthSelection();
60
+ else if (step === 'userpass')
61
+ processUserPass();
62
+ else if (step === 'request')
63
+ processRequest();
64
+ }
65
+ function processAuthSelection() {
66
+ // Need at least VER + NMETHODS
67
+ if (buf.length < 2)
68
+ return;
69
+ if (buf[0] !== 0x05) {
70
+ socket.destroy();
71
+ return;
72
+ }
73
+ const nmethods = buf[1];
74
+ if (buf.length < 2 + nmethods)
75
+ return;
76
+ const methods = Array.from(buf.subarray(2, 2 + nmethods));
77
+ buf = buf.subarray(2 + nmethods);
78
+ const needAuth = !!(auth?.verify || auth?.credentials);
79
+ if (needAuth) {
80
+ if (methods.includes(0x02)) {
81
+ socket.write(Buffer.from([0x05, 0x02]));
82
+ step = 'userpass';
83
+ process();
84
+ }
85
+ else {
86
+ socket.write(Buffer.from([0x05, 0xff]));
87
+ socket.end();
88
+ }
89
+ }
90
+ else {
91
+ if (methods.includes(0x00)) {
92
+ socket.write(Buffer.from([0x05, 0x00]));
93
+ step = 'request';
94
+ process();
95
+ }
96
+ else if (methods.includes(0x02)) {
97
+ // Accept userpass negotiation even without configured auth (auto-approve)
98
+ socket.write(Buffer.from([0x05, 0x02]));
99
+ step = 'userpass';
100
+ process();
101
+ }
102
+ else {
103
+ socket.write(Buffer.from([0x05, 0xff]));
104
+ socket.end();
105
+ }
106
+ }
107
+ }
108
+ function processUserPass() {
109
+ // VER(1) ULEN(1) U(ULEN) PLEN(1) P(PLEN) — minimum 3 bytes
110
+ if (buf.length < 3)
111
+ return;
112
+ const ulen = buf[1];
113
+ if (buf.length < 3 + ulen)
114
+ return;
115
+ const plen = buf[2 + ulen];
116
+ if (buf.length < 3 + ulen + plen)
117
+ return;
118
+ const username = buf.subarray(2, 2 + ulen).toString('utf8');
119
+ const password = buf.subarray(3 + ulen, 3 + ulen + plen).toString('utf8');
120
+ buf = buf.subarray(3 + ulen + plen);
121
+ suspended = true;
122
+ verifyProxyAuth(auth, { username, password })
123
+ .then((ok) => {
124
+ suspended = false;
125
+ if (!ok) {
126
+ mutable.authFailures++;
127
+ socket.write(Buffer.from([0x01, 0x01]));
128
+ socket.destroy();
129
+ }
130
+ else {
131
+ socket.write(Buffer.from([0x01, 0x00]));
132
+ step = 'request';
133
+ process();
134
+ }
135
+ })
136
+ .catch(() => {
137
+ suspended = false;
138
+ socket.destroy();
139
+ });
140
+ }
141
+ function processRequest() {
142
+ // VER CMD RSV ATYP ... — minimum 4 bytes
143
+ if (buf.length < 4)
144
+ return;
145
+ if (buf[0] !== 0x05) {
146
+ socket.write(socks5Reply(REP_GENERAL_FAILURE));
147
+ socket.destroy();
148
+ return;
149
+ }
150
+ const cmd = buf[1];
151
+ const atyp = buf[3];
152
+ let host;
153
+ let port;
154
+ let consumed;
155
+ let atype;
156
+ if (atyp === 0x01) {
157
+ // IPv4: 4 bytes + 2 bytes port = total 10 bytes
158
+ if (buf.length < 10)
159
+ return;
160
+ host = `${buf[4]}.${buf[5]}.${buf[6]}.${buf[7]}`;
161
+ port = buf.readUInt16BE(8);
162
+ consumed = 10;
163
+ atype = 'ipv4';
164
+ }
165
+ else if (atyp === 0x03) {
166
+ // Hostname: 1 byte len + N bytes + 2 bytes port
167
+ if (buf.length < 5)
168
+ return;
169
+ const hlen = buf[4];
170
+ if (buf.length < 5 + hlen + 2)
171
+ return;
172
+ host = buf.subarray(5, 5 + hlen).toString('utf8');
173
+ port = buf.readUInt16BE(5 + hlen);
174
+ consumed = 5 + hlen + 2;
175
+ atype = 'hostname';
176
+ }
177
+ else if (atyp === 0x04) {
178
+ // IPv6: 16 bytes + 2 bytes port = total 22 bytes
179
+ if (buf.length < 22)
180
+ return;
181
+ const parts = [];
182
+ for (let i = 0; i < 8; i++) {
183
+ parts.push(buf.readUInt16BE(4 + i * 2).toString(16));
184
+ }
185
+ host = parts.join(':');
186
+ port = buf.readUInt16BE(20);
187
+ consumed = 22;
188
+ atype = 'ipv6';
189
+ }
190
+ else {
191
+ socket.write(socks5Reply(REP_ATYP_NOT_SUPPORTED));
192
+ socket.destroy();
193
+ return;
194
+ }
195
+ if (cmd !== 0x01) {
196
+ socket.write(socks5Reply(REP_CMD_NOT_SUPPORTED));
197
+ socket.destroy();
198
+ return;
199
+ }
200
+ const remaining = buf.length > consumed ? buf.subarray(consumed) : Buffer.alloc(0);
201
+ buf = Buffer.alloc(0);
202
+ step = 'done';
203
+ // Remove data listener — piping takes over
204
+ socket.off('data', onData);
205
+ mutable.connectionsTotal++;
206
+ mutable.connectionsActive++;
207
+ const info = { host, port, clientAddress: socket.remoteAddress ?? 'unknown', atype };
208
+ onConnect?.(info);
209
+ const upstream = netConnect({ host, port });
210
+ upstream.setTimeout(connectTimeout);
211
+ upstream.on('connect', () => {
212
+ upstream.setTimeout(0);
213
+ socket.write(socks5Reply(REP_SUCCESS));
214
+ if (remaining.length > 0)
215
+ upstream.write(remaining);
216
+ pipeBidirectional(socket, upstream, {
217
+ onStats: (s) => {
218
+ mutable.bytesFromClient += s.bytesFromA;
219
+ mutable.bytesToClient += s.bytesToA;
220
+ },
221
+ onEnd: () => {
222
+ mutable.connectionsActive--;
223
+ onDisconnect?.({ ...info, reason: 'closed' });
224
+ },
225
+ onError: (err) => {
226
+ mutable.connectionsErrored++;
227
+ mutable.connectionsActive--;
228
+ onDisconnect?.({ ...info, reason: err.message });
229
+ },
230
+ });
231
+ });
232
+ upstream.on('timeout', () => {
233
+ upstream.destroy(new Error('connect timeout'));
234
+ });
235
+ upstream.on('error', (err) => {
236
+ mutable.connectionsErrored++;
237
+ mutable.connectionsActive--;
238
+ onDisconnect?.({ ...info, reason: err.message });
239
+ const rep = mapUpstreamError(err);
240
+ if (!socket.destroyed) {
241
+ socket.write(socks5Reply(rep));
242
+ socket.destroy();
243
+ }
244
+ });
245
+ }
246
+ }
247
+ export function createSocks5Proxy(options) {
248
+ const { port, host = '0.0.0.0', maxConnections = 0 } = options;
249
+ const { mutable, snapshot } = createProxyStats();
250
+ let server = null;
251
+ let _boundPort = null;
252
+ let running = false;
253
+ return {
254
+ async start() {
255
+ return new Promise((resolve, reject) => {
256
+ server = createServer((socket) => {
257
+ if (maxConnections > 0 && mutable.connectionsActive >= maxConnections) {
258
+ socket.destroy();
259
+ return;
260
+ }
261
+ handleSocks5Connection(socket, options, mutable);
262
+ });
263
+ server.once('error', reject);
264
+ server.listen(port, host, () => {
265
+ const addr = server.address();
266
+ if (typeof addr === 'object' && addr !== null) {
267
+ _boundPort = addr.port;
268
+ running = true;
269
+ resolve(addr.port);
270
+ }
271
+ else {
272
+ reject(new Error('Failed to resolve SOCKS5 server address'));
273
+ }
274
+ });
275
+ });
276
+ },
277
+ async stop(drainTimeoutMs = 5000) {
278
+ return new Promise((resolve) => {
279
+ if (!server || !running) {
280
+ resolve();
281
+ return;
282
+ }
283
+ running = false;
284
+ _boundPort = null;
285
+ const timer = setTimeout(() => {
286
+ ;
287
+ server.closeAllConnections?.();
288
+ resolve();
289
+ }, drainTimeoutMs);
290
+ server.close(() => {
291
+ clearTimeout(timer);
292
+ resolve();
293
+ });
294
+ });
295
+ },
296
+ get stats() {
297
+ return snapshot();
298
+ },
299
+ get boundPort() {
300
+ return _boundPort;
301
+ },
302
+ get isRunning() {
303
+ return running;
304
+ },
305
+ };
306
+ }
307
+ //# sourceMappingURL=socks5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socks5.js","sourceRoot":"","sources":["../../src/proxy/socks5.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Transparent Proxy
3
+ *
4
+ * Standalone net.Server with IP_TRANSPARENT socket option (Linux + CAP_NET_ADMIN).
5
+ *
6
+ * In TPROXY mode, the kernel preserves the original destination address on
7
+ * each accepted connection, so socket.localAddress:socket.localPort gives
8
+ * the original destination.
9
+ *
10
+ * In REDIRECT mode, the original destination is typically obtainable via
11
+ * SO_ORIGINAL_DST (getsockopt), but Node.js does not expose this natively.
12
+ * We fall back to socket.localAddress (which points to the proxy, not the
13
+ * real destination) and log a warning.
14
+ *
15
+ * iptables setup for TPROXY:
16
+ * iptables -t mangle -A PREROUTING -p tcp -j TPROXY --tproxy-mark 0x1 --on-port 8080
17
+ * ip rule add fwmark 0x1 lookup 100
18
+ * ip route add local 0.0.0.0/0 dev lo table 100
19
+ */
20
+ import { type Socket } from 'node:net';
21
+ import type { ProxyServer } from './types.js';
22
+ export type TransparentProxyMode = 'tproxy' | 'redirect';
23
+ export interface TransparentProxyOptions {
24
+ port: number;
25
+ host?: string;
26
+ /** 'tproxy' requires CAP_NET_ADMIN; 'redirect' is a best-effort fallback. Default: 'tproxy' */
27
+ mode?: TransparentProxyMode;
28
+ /** Upstream connection timeout in ms. Default: 10_000 */
29
+ connectTimeout?: number;
30
+ onConnection?: (info: {
31
+ clientSocket: Socket;
32
+ clientAddress: string;
33
+ originalDest: {
34
+ host: string;
35
+ port: number;
36
+ };
37
+ }) => void;
38
+ }
39
+ export declare function createTransparentProxy(options: TransparentProxyOptions): ProxyServer;
40
+ //# sourceMappingURL=transparent.d.ts.map