pi-cursor-sdk 0.1.49 → 0.1.51

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 (278) hide show
  1. package/CHANGELOG.md +36 -1
  2. package/README.md +2 -2
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +6 -15
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-overflow.ts +96 -0
  12. package/src/cursor-tool-manifest.ts +1 -1
  13. package/src/index.ts +4 -1
  14. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  15. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  42. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  44. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  48. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  52. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  54. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  56. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  68. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  69. package/node_modules/undici/LICENSE +0 -21
  70. package/node_modules/undici/README.md +0 -741
  71. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  72. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  73. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  74. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  75. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  76. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  77. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  78. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  79. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  80. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  81. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  82. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  83. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  84. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  85. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  86. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  87. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  88. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  89. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  90. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  91. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  92. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  93. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  94. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  95. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  96. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  97. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  98. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  99. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  100. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  101. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  102. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  103. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  104. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  105. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  106. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  107. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  108. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  109. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  110. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  111. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  112. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  113. package/node_modules/undici/index-fetch.js +0 -65
  114. package/node_modules/undici/index.d.ts +0 -3
  115. package/node_modules/undici/index.js +0 -234
  116. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  117. package/node_modules/undici/lib/api/api-connect.js +0 -110
  118. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  119. package/node_modules/undici/lib/api/api-request.js +0 -214
  120. package/node_modules/undici/lib/api/api-stream.js +0 -209
  121. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  122. package/node_modules/undici/lib/api/index.js +0 -7
  123. package/node_modules/undici/lib/api/readable.js +0 -580
  124. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  125. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  126. package/node_modules/undici/lib/core/connect.js +0 -153
  127. package/node_modules/undici/lib/core/constants.js +0 -143
  128. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  129. package/node_modules/undici/lib/core/errors.js +0 -477
  130. package/node_modules/undici/lib/core/request.js +0 -453
  131. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  132. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  133. package/node_modules/undici/lib/core/symbols.js +0 -75
  134. package/node_modules/undici/lib/core/tree.js +0 -160
  135. package/node_modules/undici/lib/core/util.js +0 -992
  136. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  137. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  138. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  139. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  140. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  141. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  142. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  143. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  144. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  145. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  146. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  147. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  148. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  149. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  150. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  151. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  152. package/node_modules/undici/lib/encoding/index.js +0 -33
  153. package/node_modules/undici/lib/global.js +0 -59
  154. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  155. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  156. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  157. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  158. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  159. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  160. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  161. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  162. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  163. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  164. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  165. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  166. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  167. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  168. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  169. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  170. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  171. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  172. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  173. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  174. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  176. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  177. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  178. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  179. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  180. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  181. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  182. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  183. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  184. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  185. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  186. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  187. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  188. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  189. package/node_modules/undici/lib/util/cache.js +0 -414
  190. package/node_modules/undici/lib/util/date.js +0 -653
  191. package/node_modules/undici/lib/util/promise.js +0 -28
  192. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  193. package/node_modules/undici/lib/util/stats.js +0 -32
  194. package/node_modules/undici/lib/util/timers.js +0 -425
  195. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  196. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  197. package/node_modules/undici/lib/web/cache/util.js +0 -45
  198. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  199. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  200. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  201. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  202. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  203. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  204. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  205. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  206. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  207. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  208. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  209. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  210. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  211. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  212. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  213. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  214. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  215. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  216. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  217. package/node_modules/undici/lib/web/infra/index.js +0 -229
  218. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  219. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  220. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  221. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  222. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  223. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  224. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  225. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  226. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  227. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  228. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  229. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  230. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  231. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  232. package/node_modules/undici/package.json +0 -152
  233. package/node_modules/undici/scripts/strip-comments.js +0 -10
  234. package/node_modules/undici/types/README.md +0 -6
  235. package/node_modules/undici/types/agent.d.ts +0 -32
  236. package/node_modules/undici/types/api.d.ts +0 -43
  237. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  238. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  239. package/node_modules/undici/types/cache.d.ts +0 -36
  240. package/node_modules/undici/types/client-stats.d.ts +0 -15
  241. package/node_modules/undici/types/client.d.ts +0 -139
  242. package/node_modules/undici/types/connector.d.ts +0 -36
  243. package/node_modules/undici/types/content-type.d.ts +0 -21
  244. package/node_modules/undici/types/cookies.d.ts +0 -30
  245. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  246. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  247. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  248. package/node_modules/undici/types/errors.d.ts +0 -177
  249. package/node_modules/undici/types/eventsource.d.ts +0 -66
  250. package/node_modules/undici/types/fetch.d.ts +0 -231
  251. package/node_modules/undici/types/formdata.d.ts +0 -114
  252. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  253. package/node_modules/undici/types/global-origin.d.ts +0 -7
  254. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  255. package/node_modules/undici/types/handlers.d.ts +0 -14
  256. package/node_modules/undici/types/header.d.ts +0 -160
  257. package/node_modules/undici/types/index.d.ts +0 -91
  258. package/node_modules/undici/types/interceptors.d.ts +0 -80
  259. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  260. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  261. package/node_modules/undici/types/mock-client.d.ts +0 -27
  262. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  263. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  264. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  265. package/node_modules/undici/types/patch.d.ts +0 -29
  266. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  267. package/node_modules/undici/types/pool.d.ts +0 -41
  268. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  269. package/node_modules/undici/types/readable.d.ts +0 -68
  270. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  271. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  272. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  273. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  274. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  275. package/node_modules/undici/types/util.d.ts +0 -18
  276. package/node_modules/undici/types/utility.d.ts +0 -7
  277. package/node_modules/undici/types/webidl.d.ts +0 -347
  278. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -1,234 +0,0 @@
1
- 'use strict'
2
-
3
- const { Writable } = require('node:stream')
4
- const { EventEmitter } = require('node:events')
5
- const { assertCacheKey, assertCacheValue } = require('../util/cache.js')
6
-
7
- /**
8
- * @typedef {import('../../types/cache-interceptor.d.ts').default.CacheKey} CacheKey
9
- * @typedef {import('../../types/cache-interceptor.d.ts').default.CacheValue} CacheValue
10
- * @typedef {import('../../types/cache-interceptor.d.ts').default.CacheStore} CacheStore
11
- * @typedef {import('../../types/cache-interceptor.d.ts').default.GetResult} GetResult
12
- */
13
-
14
- /**
15
- * @implements {CacheStore}
16
- * @extends {EventEmitter}
17
- */
18
- class MemoryCacheStore extends EventEmitter {
19
- #maxCount = 1024
20
- #maxSize = 104857600 // 100MB
21
- #maxEntrySize = 5242880 // 5MB
22
-
23
- #size = 0
24
- #count = 0
25
- #entries = new Map()
26
- #hasEmittedMaxSizeEvent = false
27
-
28
- /**
29
- * @param {import('../../types/cache-interceptor.d.ts').default.MemoryCacheStoreOpts | undefined} [opts]
30
- */
31
- constructor (opts) {
32
- super()
33
- if (opts) {
34
- if (typeof opts !== 'object') {
35
- throw new TypeError('MemoryCacheStore options must be an object')
36
- }
37
-
38
- if (opts.maxCount !== undefined) {
39
- if (
40
- typeof opts.maxCount !== 'number' ||
41
- !Number.isInteger(opts.maxCount) ||
42
- opts.maxCount < 0
43
- ) {
44
- throw new TypeError('MemoryCacheStore options.maxCount must be a non-negative integer')
45
- }
46
- this.#maxCount = opts.maxCount
47
- }
48
-
49
- if (opts.maxSize !== undefined) {
50
- if (
51
- typeof opts.maxSize !== 'number' ||
52
- !Number.isInteger(opts.maxSize) ||
53
- opts.maxSize < 0
54
- ) {
55
- throw new TypeError('MemoryCacheStore options.maxSize must be a non-negative integer')
56
- }
57
- this.#maxSize = opts.maxSize
58
- }
59
-
60
- if (opts.maxEntrySize !== undefined) {
61
- if (
62
- typeof opts.maxEntrySize !== 'number' ||
63
- !Number.isInteger(opts.maxEntrySize) ||
64
- opts.maxEntrySize < 0
65
- ) {
66
- throw new TypeError('MemoryCacheStore options.maxEntrySize must be a non-negative integer')
67
- }
68
- this.#maxEntrySize = opts.maxEntrySize
69
- }
70
- }
71
- }
72
-
73
- /**
74
- * Get the current size of the cache in bytes
75
- * @returns {number} The current size of the cache in bytes
76
- */
77
- get size () {
78
- return this.#size
79
- }
80
-
81
- /**
82
- * Check if the cache is full (either max size or max count reached)
83
- * @returns {boolean} True if the cache is full, false otherwise
84
- */
85
- isFull () {
86
- return this.#size >= this.#maxSize || this.#count >= this.#maxCount
87
- }
88
-
89
- /**
90
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} req
91
- * @returns {import('../../types/cache-interceptor.d.ts').default.GetResult | undefined}
92
- */
93
- get (key) {
94
- assertCacheKey(key)
95
-
96
- const topLevelKey = `${key.origin}:${key.path}`
97
-
98
- const now = Date.now()
99
- const entries = this.#entries.get(topLevelKey)
100
-
101
- const entry = entries ? findEntry(key, entries, now) : null
102
-
103
- return entry == null
104
- ? undefined
105
- : {
106
- statusMessage: entry.statusMessage,
107
- statusCode: entry.statusCode,
108
- headers: entry.headers,
109
- body: entry.body,
110
- vary: entry.vary ? entry.vary : undefined,
111
- etag: entry.etag,
112
- cacheControlDirectives: entry.cacheControlDirectives,
113
- cachedAt: entry.cachedAt,
114
- staleAt: entry.staleAt,
115
- deleteAt: entry.deleteAt
116
- }
117
- }
118
-
119
- /**
120
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
121
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheValue} val
122
- * @returns {Writable | undefined}
123
- */
124
- createWriteStream (key, val) {
125
- assertCacheKey(key)
126
- assertCacheValue(val)
127
-
128
- const topLevelKey = `${key.origin}:${key.path}`
129
-
130
- const store = this
131
- const entry = { ...key, ...val, body: [], size: 0 }
132
-
133
- return new Writable({
134
- write (chunk, encoding, callback) {
135
- if (typeof chunk === 'string') {
136
- chunk = Buffer.from(chunk, encoding)
137
- }
138
-
139
- entry.size += chunk.byteLength
140
-
141
- if (entry.size >= store.#maxEntrySize) {
142
- this.destroy()
143
- } else {
144
- entry.body.push(chunk)
145
- }
146
-
147
- callback(null)
148
- },
149
- final (callback) {
150
- let entries = store.#entries.get(topLevelKey)
151
- if (!entries) {
152
- entries = []
153
- store.#entries.set(topLevelKey, entries)
154
- }
155
- const previousEntry = findEntry(key, entries, Date.now())
156
- if (previousEntry) {
157
- const index = entries.indexOf(previousEntry)
158
- entries.splice(index, 1, entry)
159
- store.#size -= previousEntry.size
160
- } else {
161
- entries.push(entry)
162
- store.#count += 1
163
- }
164
-
165
- store.#size += entry.size
166
-
167
- // Check if cache is full and emit event if needed
168
- if (store.#size > store.#maxSize || store.#count > store.#maxCount) {
169
- // Emit maxSizeExceeded event if we haven't already
170
- if (!store.#hasEmittedMaxSizeEvent) {
171
- store.emit('maxSizeExceeded', {
172
- size: store.#size,
173
- maxSize: store.#maxSize,
174
- count: store.#count,
175
- maxCount: store.#maxCount
176
- })
177
- store.#hasEmittedMaxSizeEvent = true
178
- }
179
-
180
- // Perform eviction
181
- for (const [key, entries] of store.#entries) {
182
- for (const entry of entries.splice(0, entries.length / 2)) {
183
- store.#size -= entry.size
184
- store.#count -= 1
185
- }
186
- if (entries.length === 0) {
187
- store.#entries.delete(key)
188
- }
189
- }
190
-
191
- // Reset the event flag after eviction
192
- if (store.#size < store.#maxSize && store.#count < store.#maxCount) {
193
- store.#hasEmittedMaxSizeEvent = false
194
- }
195
- }
196
-
197
- callback(null)
198
- }
199
- })
200
- }
201
-
202
- /**
203
- * @param {CacheKey} key
204
- */
205
- delete (key) {
206
- if (typeof key !== 'object') {
207
- throw new TypeError(`expected key to be object, got ${typeof key}`)
208
- }
209
-
210
- const topLevelKey = `${key.origin}:${key.path}`
211
-
212
- for (const entry of this.#entries.get(topLevelKey) ?? []) {
213
- this.#size -= entry.size
214
- this.#count -= 1
215
- }
216
- this.#entries.delete(topLevelKey)
217
- }
218
- }
219
-
220
- function findEntry (key, entries, now) {
221
- return entries.find((entry) => (
222
- entry.deleteAt > now &&
223
- entry.method === key.method &&
224
- (entry.vary == null || Object.keys(entry.vary).every(headerName => {
225
- if (entry.vary[headerName] === null) {
226
- return key.headers[headerName] === undefined
227
- }
228
-
229
- return entry.vary[headerName] === key.headers[headerName]
230
- }))
231
- ))
232
- }
233
-
234
- module.exports = MemoryCacheStore
@@ -1,461 +0,0 @@
1
- 'use strict'
2
-
3
- const { Writable } = require('node:stream')
4
- const { assertCacheKey, assertCacheValue } = require('../util/cache.js')
5
-
6
- let DatabaseSync
7
-
8
- const VERSION = 3
9
-
10
- // 2gb
11
- const MAX_ENTRY_SIZE = 2 * 1000 * 1000 * 1000
12
-
13
- /**
14
- * @typedef {import('../../types/cache-interceptor.d.ts').default.CacheStore} CacheStore
15
- * @implements {CacheStore}
16
- *
17
- * @typedef {{
18
- * id: Readonly<number>,
19
- * body?: Uint8Array
20
- * statusCode: number
21
- * statusMessage: string
22
- * headers?: string
23
- * vary?: string
24
- * etag?: string
25
- * cacheControlDirectives?: string
26
- * cachedAt: number
27
- * staleAt: number
28
- * deleteAt: number
29
- * }} SqliteStoreValue
30
- */
31
- module.exports = class SqliteCacheStore {
32
- #maxEntrySize = MAX_ENTRY_SIZE
33
- #maxCount = Infinity
34
-
35
- /**
36
- * @type {import('node:sqlite').DatabaseSync}
37
- */
38
- #db
39
-
40
- /**
41
- * @type {import('node:sqlite').StatementSync}
42
- */
43
- #getValuesQuery
44
-
45
- /**
46
- * @type {import('node:sqlite').StatementSync}
47
- */
48
- #updateValueQuery
49
-
50
- /**
51
- * @type {import('node:sqlite').StatementSync}
52
- */
53
- #insertValueQuery
54
-
55
- /**
56
- * @type {import('node:sqlite').StatementSync}
57
- */
58
- #deleteExpiredValuesQuery
59
-
60
- /**
61
- * @type {import('node:sqlite').StatementSync}
62
- */
63
- #deleteByUrlQuery
64
-
65
- /**
66
- * @type {import('node:sqlite').StatementSync}
67
- */
68
- #countEntriesQuery
69
-
70
- /**
71
- * @type {import('node:sqlite').StatementSync | null}
72
- */
73
- #deleteOldValuesQuery
74
-
75
- /**
76
- * @param {import('../../types/cache-interceptor.d.ts').default.SqliteCacheStoreOpts | undefined} opts
77
- */
78
- constructor (opts) {
79
- if (opts) {
80
- if (typeof opts !== 'object') {
81
- throw new TypeError('SqliteCacheStore options must be an object')
82
- }
83
-
84
- if (opts.maxEntrySize !== undefined) {
85
- if (
86
- typeof opts.maxEntrySize !== 'number' ||
87
- !Number.isInteger(opts.maxEntrySize) ||
88
- opts.maxEntrySize < 0
89
- ) {
90
- throw new TypeError('SqliteCacheStore options.maxEntrySize must be a non-negative integer')
91
- }
92
-
93
- if (opts.maxEntrySize > MAX_ENTRY_SIZE) {
94
- throw new TypeError('SqliteCacheStore options.maxEntrySize must be less than 2gb')
95
- }
96
-
97
- this.#maxEntrySize = opts.maxEntrySize
98
- }
99
-
100
- if (opts.maxCount !== undefined) {
101
- if (
102
- typeof opts.maxCount !== 'number' ||
103
- !Number.isInteger(opts.maxCount) ||
104
- opts.maxCount < 0
105
- ) {
106
- throw new TypeError('SqliteCacheStore options.maxCount must be a non-negative integer')
107
- }
108
- this.#maxCount = opts.maxCount
109
- }
110
- }
111
-
112
- if (!DatabaseSync) {
113
- DatabaseSync = require('node:sqlite').DatabaseSync
114
- }
115
- this.#db = new DatabaseSync(opts?.location ?? ':memory:')
116
-
117
- this.#db.exec(`
118
- PRAGMA journal_mode = WAL;
119
- PRAGMA synchronous = NORMAL;
120
- PRAGMA temp_store = memory;
121
- PRAGMA optimize;
122
-
123
- CREATE TABLE IF NOT EXISTS cacheInterceptorV${VERSION} (
124
- -- Data specific to us
125
- id INTEGER PRIMARY KEY AUTOINCREMENT,
126
- url TEXT NOT NULL,
127
- method TEXT NOT NULL,
128
-
129
- -- Data returned to the interceptor
130
- body BUF NULL,
131
- deleteAt INTEGER NOT NULL,
132
- statusCode INTEGER NOT NULL,
133
- statusMessage TEXT NOT NULL,
134
- headers TEXT NULL,
135
- cacheControlDirectives TEXT NULL,
136
- etag TEXT NULL,
137
- vary TEXT NULL,
138
- cachedAt INTEGER NOT NULL,
139
- staleAt INTEGER NOT NULL
140
- );
141
-
142
- CREATE INDEX IF NOT EXISTS idx_cacheInterceptorV${VERSION}_getValuesQuery ON cacheInterceptorV${VERSION}(url, method, deleteAt);
143
- CREATE INDEX IF NOT EXISTS idx_cacheInterceptorV${VERSION}_deleteByUrlQuery ON cacheInterceptorV${VERSION}(deleteAt);
144
- `)
145
-
146
- this.#getValuesQuery = this.#db.prepare(`
147
- SELECT
148
- id,
149
- body,
150
- deleteAt,
151
- statusCode,
152
- statusMessage,
153
- headers,
154
- etag,
155
- cacheControlDirectives,
156
- vary,
157
- cachedAt,
158
- staleAt
159
- FROM cacheInterceptorV${VERSION}
160
- WHERE
161
- url = ?
162
- AND method = ?
163
- ORDER BY
164
- deleteAt ASC
165
- `)
166
-
167
- this.#updateValueQuery = this.#db.prepare(`
168
- UPDATE cacheInterceptorV${VERSION} SET
169
- body = ?,
170
- deleteAt = ?,
171
- statusCode = ?,
172
- statusMessage = ?,
173
- headers = ?,
174
- etag = ?,
175
- cacheControlDirectives = ?,
176
- cachedAt = ?,
177
- staleAt = ?
178
- WHERE
179
- id = ?
180
- `)
181
-
182
- this.#insertValueQuery = this.#db.prepare(`
183
- INSERT INTO cacheInterceptorV${VERSION} (
184
- url,
185
- method,
186
- body,
187
- deleteAt,
188
- statusCode,
189
- statusMessage,
190
- headers,
191
- etag,
192
- cacheControlDirectives,
193
- vary,
194
- cachedAt,
195
- staleAt
196
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
197
- `)
198
-
199
- this.#deleteByUrlQuery = this.#db.prepare(
200
- `DELETE FROM cacheInterceptorV${VERSION} WHERE url = ?`
201
- )
202
-
203
- this.#countEntriesQuery = this.#db.prepare(
204
- `SELECT COUNT(*) AS total FROM cacheInterceptorV${VERSION}`
205
- )
206
-
207
- this.#deleteExpiredValuesQuery = this.#db.prepare(
208
- `DELETE FROM cacheInterceptorV${VERSION} WHERE deleteAt <= ?`
209
- )
210
-
211
- this.#deleteOldValuesQuery = this.#maxCount === Infinity
212
- ? null
213
- : this.#db.prepare(`
214
- DELETE FROM cacheInterceptorV${VERSION}
215
- WHERE id IN (
216
- SELECT
217
- id
218
- FROM cacheInterceptorV${VERSION}
219
- ORDER BY cachedAt ASC
220
- LIMIT ?
221
- )
222
- `)
223
- }
224
-
225
- close () {
226
- this.#db.close()
227
- }
228
-
229
- /**
230
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
231
- * @returns {(import('../../types/cache-interceptor.d.ts').default.GetResult & { body?: Buffer }) | undefined}
232
- */
233
- get (key) {
234
- assertCacheKey(key)
235
-
236
- const value = this.#findValue(key)
237
- return value
238
- ? {
239
- body: value.body ? Buffer.from(value.body.buffer, value.body.byteOffset, value.body.byteLength) : undefined,
240
- statusCode: value.statusCode,
241
- statusMessage: value.statusMessage,
242
- headers: value.headers ? JSON.parse(value.headers) : undefined,
243
- etag: value.etag ? value.etag : undefined,
244
- vary: value.vary ? JSON.parse(value.vary) : undefined,
245
- cacheControlDirectives: value.cacheControlDirectives
246
- ? JSON.parse(value.cacheControlDirectives)
247
- : undefined,
248
- cachedAt: value.cachedAt,
249
- staleAt: value.staleAt,
250
- deleteAt: value.deleteAt
251
- }
252
- : undefined
253
- }
254
-
255
- /**
256
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
257
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheValue & { body: null | Buffer | Array<Buffer>}} value
258
- */
259
- set (key, value) {
260
- assertCacheKey(key)
261
-
262
- const url = this.#makeValueUrl(key)
263
- const body = Array.isArray(value.body) ? Buffer.concat(value.body) : value.body
264
- const size = body?.byteLength
265
-
266
- if (size && size > this.#maxEntrySize) {
267
- return
268
- }
269
-
270
- const existingValue = this.#findValue(key, true)
271
- if (existingValue) {
272
- // Updating an existing response, let's overwrite it
273
- this.#updateValueQuery.run(
274
- body,
275
- value.deleteAt,
276
- value.statusCode,
277
- value.statusMessage,
278
- value.headers ? JSON.stringify(value.headers) : null,
279
- value.etag ? value.etag : null,
280
- value.cacheControlDirectives ? JSON.stringify(value.cacheControlDirectives) : null,
281
- value.cachedAt,
282
- value.staleAt,
283
- existingValue.id
284
- )
285
- } else {
286
- // New response, let's insert it
287
- this.#insertValueQuery.run(
288
- url,
289
- key.method,
290
- body,
291
- value.deleteAt,
292
- value.statusCode,
293
- value.statusMessage,
294
- value.headers ? JSON.stringify(value.headers) : null,
295
- value.etag ? value.etag : null,
296
- value.cacheControlDirectives ? JSON.stringify(value.cacheControlDirectives) : null,
297
- value.vary ? JSON.stringify(value.vary) : null,
298
- value.cachedAt,
299
- value.staleAt
300
- )
301
- this.#prune()
302
- }
303
- }
304
-
305
- /**
306
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
307
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheValue} value
308
- * @returns {Writable | undefined}
309
- */
310
- createWriteStream (key, value) {
311
- assertCacheKey(key)
312
- assertCacheValue(value)
313
-
314
- let size = 0
315
- /**
316
- * @type {Buffer[] | null}
317
- */
318
- const body = []
319
- const store = this
320
-
321
- return new Writable({
322
- decodeStrings: true,
323
- write (chunk, encoding, callback) {
324
- size += chunk.byteLength
325
-
326
- if (size < store.#maxEntrySize) {
327
- body.push(chunk)
328
- } else {
329
- this.destroy()
330
- }
331
-
332
- callback()
333
- },
334
- final (callback) {
335
- store.set(key, { ...value, body })
336
- callback()
337
- }
338
- })
339
- }
340
-
341
- /**
342
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
343
- */
344
- delete (key) {
345
- if (typeof key !== 'object') {
346
- throw new TypeError(`expected key to be object, got ${typeof key}`)
347
- }
348
-
349
- this.#deleteByUrlQuery.run(this.#makeValueUrl(key))
350
- }
351
-
352
- #prune () {
353
- if (Number.isFinite(this.#maxCount) && this.size <= this.#maxCount) {
354
- return 0
355
- }
356
-
357
- {
358
- const removed = this.#deleteExpiredValuesQuery.run(Date.now()).changes
359
- if (removed) {
360
- return removed
361
- }
362
- }
363
-
364
- {
365
- const removed = this.#deleteOldValuesQuery?.run(Math.max(Math.floor(this.#maxCount * 0.1), 1)).changes
366
- if (removed) {
367
- return removed
368
- }
369
- }
370
-
371
- return 0
372
- }
373
-
374
- /**
375
- * Counts the number of rows in the cache
376
- * @returns {Number}
377
- */
378
- get size () {
379
- const { total } = this.#countEntriesQuery.get()
380
- return total
381
- }
382
-
383
- /**
384
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
385
- * @returns {string}
386
- */
387
- #makeValueUrl (key) {
388
- return `${key.origin}/${key.path}`
389
- }
390
-
391
- /**
392
- * @param {import('../../types/cache-interceptor.d.ts').default.CacheKey} key
393
- * @param {boolean} [canBeExpired=false]
394
- * @returns {SqliteStoreValue | undefined}
395
- */
396
- #findValue (key, canBeExpired = false) {
397
- const url = this.#makeValueUrl(key)
398
- const { headers, method } = key
399
-
400
- /**
401
- * @type {SqliteStoreValue[]}
402
- */
403
- const values = this.#getValuesQuery.all(url, method)
404
-
405
- if (values.length === 0) {
406
- return undefined
407
- }
408
-
409
- const now = Date.now()
410
- for (const value of values) {
411
- if (now >= value.deleteAt && !canBeExpired) {
412
- continue
413
- }
414
-
415
- let matches = true
416
-
417
- if (value.vary) {
418
- const vary = JSON.parse(value.vary)
419
-
420
- for (const header in vary) {
421
- if (!headerValueEquals(headers[header], vary[header])) {
422
- matches = false
423
- break
424
- }
425
- }
426
- }
427
-
428
- if (matches) {
429
- return value
430
- }
431
- }
432
-
433
- return undefined
434
- }
435
- }
436
-
437
- /**
438
- * @param {string|string[]|null|undefined} lhs
439
- * @param {string|string[]|null|undefined} rhs
440
- * @returns {boolean}
441
- */
442
- function headerValueEquals (lhs, rhs) {
443
- if (lhs == null && rhs == null) {
444
- return true
445
- }
446
-
447
- if ((lhs == null && rhs != null) ||
448
- (lhs != null && rhs == null)) {
449
- return false
450
- }
451
-
452
- if (Array.isArray(lhs) && Array.isArray(rhs)) {
453
- if (lhs.length !== rhs.length) {
454
- return false
455
- }
456
-
457
- return lhs.every((x, i) => x === rhs[i])
458
- }
459
-
460
- return lhs === rhs
461
- }