@xtandard/kit 0.0.0-stage → 0.1.0

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 (402) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +71 -2
  3. package/bin/xtandard-kit.mjs +3 -0
  4. package/dist/base-path-BJugWLNO.cjs +42 -0
  5. package/dist/base-path-BJugWLNO.cjs.map +1 -0
  6. package/dist/base-path-CDb4In5E.mjs +31 -0
  7. package/dist/base-path-CDb4In5E.mjs.map +1 -0
  8. package/dist/basic-Qtriv0xS.mjs +176 -0
  9. package/dist/basic-Qtriv0xS.mjs.map +1 -0
  10. package/dist/basic-ZaO92-lB.cjs +199 -0
  11. package/dist/basic-ZaO92-lB.cjs.map +1 -0
  12. package/dist/bin.cjs +126 -0
  13. package/dist/bin.cjs.map +1 -0
  14. package/dist/bin.d.cts +20 -0
  15. package/dist/bin.d.mts +20 -0
  16. package/dist/bin.mjs +125 -0
  17. package/dist/bin.mjs.map +1 -0
  18. package/dist/cas-CuPSaXBV.cjs +23 -0
  19. package/dist/cas-CuPSaXBV.cjs.map +1 -0
  20. package/dist/cas-CzA-yECx.mjs +18 -0
  21. package/dist/cas-CzA-yECx.mjs.map +1 -0
  22. package/dist/chunk-DakpK96I.cjs +43 -0
  23. package/dist/contract-B3UPXXLx.d.cts +30 -0
  24. package/dist/contract-B3UPXXLx.d.mts +30 -0
  25. package/dist/contract-BDPNvjtp.d.mts +64 -0
  26. package/dist/contract-BEdfGTPs.mjs +85 -0
  27. package/dist/contract-BEdfGTPs.mjs.map +1 -0
  28. package/dist/contract-BIVzAn4f.d.cts +64 -0
  29. package/dist/contract-BvgtswLX.d.cts +75 -0
  30. package/dist/contract-BvgtswLX.d.mts +75 -0
  31. package/dist/contract-DUj9P3Vt.d.cts +72 -0
  32. package/dist/contract-DUj9P3Vt.d.mts +72 -0
  33. package/dist/contract-wAEMDmYG.cjs +132 -0
  34. package/dist/contract-wAEMDmYG.cjs.map +1 -0
  35. package/dist/drizzle-BElCHWri.d.mts +115 -0
  36. package/dist/drizzle-BXaQXCr0.cjs +232 -0
  37. package/dist/drizzle-BXaQXCr0.cjs.map +1 -0
  38. package/dist/drizzle-CEpahWQB.d.cts +115 -0
  39. package/dist/drizzle-DxnelsPT.mjs +197 -0
  40. package/dist/drizzle-DxnelsPT.mjs.map +1 -0
  41. package/dist/duration-7WpAK-xe.mjs +52 -0
  42. package/dist/duration-7WpAK-xe.mjs.map +1 -0
  43. package/dist/duration-DVA0Fzkx.cjs +63 -0
  44. package/dist/duration-DVA0Fzkx.cjs.map +1 -0
  45. package/dist/duration-FPwbmWIU.d.cts +35 -0
  46. package/dist/duration-FPwbmWIU.d.mts +35 -0
  47. package/dist/entry-adapters-bun.cjs +10 -0
  48. package/dist/entry-adapters-bun.cjs.map +1 -0
  49. package/dist/entry-adapters-bun.d.cts +10 -0
  50. package/dist/entry-adapters-bun.d.mts +10 -0
  51. package/dist/entry-adapters-bun.mjs +9 -0
  52. package/dist/entry-adapters-bun.mjs.map +1 -0
  53. package/dist/entry-adapters-elysia.cjs +54 -0
  54. package/dist/entry-adapters-elysia.cjs.map +1 -0
  55. package/dist/entry-adapters-elysia.d.cts +38 -0
  56. package/dist/entry-adapters-elysia.d.mts +38 -0
  57. package/dist/entry-adapters-elysia.mjs +53 -0
  58. package/dist/entry-adapters-elysia.mjs.map +1 -0
  59. package/dist/entry-adapters-express.cjs +27 -0
  60. package/dist/entry-adapters-express.cjs.map +1 -0
  61. package/dist/entry-adapters-express.d.cts +24 -0
  62. package/dist/entry-adapters-express.d.mts +24 -0
  63. package/dist/entry-adapters-express.mjs +26 -0
  64. package/dist/entry-adapters-express.mjs.map +1 -0
  65. package/dist/entry-adapters-hono.cjs +33 -0
  66. package/dist/entry-adapters-hono.cjs.map +1 -0
  67. package/dist/entry-adapters-hono.d.cts +36 -0
  68. package/dist/entry-adapters-hono.d.mts +36 -0
  69. package/dist/entry-adapters-hono.mjs +30 -0
  70. package/dist/entry-adapters-hono.mjs.map +1 -0
  71. package/dist/entry-adapters-next.cjs +19 -0
  72. package/dist/entry-adapters-next.cjs.map +1 -0
  73. package/dist/entry-adapters-next.d.cts +35 -0
  74. package/dist/entry-adapters-next.d.mts +35 -0
  75. package/dist/entry-adapters-next.mjs +18 -0
  76. package/dist/entry-adapters-next.mjs.map +1 -0
  77. package/dist/entry-adapters-node.cjs +7 -0
  78. package/dist/entry-adapters-node.d.cts +2 -0
  79. package/dist/entry-adapters-node.d.mts +2 -0
  80. package/dist/entry-adapters-node.mjs +2 -0
  81. package/dist/entry-auth-basic.cjs +5 -0
  82. package/dist/entry-auth-basic.d.cts +83 -0
  83. package/dist/entry-auth-basic.d.mts +83 -0
  84. package/dist/entry-auth-basic.mjs +2 -0
  85. package/dist/entry-auth-delegated.cjs +28 -0
  86. package/dist/entry-auth-delegated.cjs.map +1 -0
  87. package/dist/entry-auth-delegated.d.cts +36 -0
  88. package/dist/entry-auth-delegated.d.mts +36 -0
  89. package/dist/entry-auth-delegated.mjs +27 -0
  90. package/dist/entry-auth-delegated.mjs.map +1 -0
  91. package/dist/entry-auth-none.cjs +4 -0
  92. package/dist/entry-auth-none.d.cts +25 -0
  93. package/dist/entry-auth-none.d.mts +25 -0
  94. package/dist/entry-auth-none.mjs +2 -0
  95. package/dist/entry-auth.cjs +0 -0
  96. package/dist/entry-auth.d.cts +2 -0
  97. package/dist/entry-auth.d.mts +2 -0
  98. package/dist/entry-auth.mjs +1 -0
  99. package/dist/entry-authorization-delegated.cjs +27 -0
  100. package/dist/entry-authorization-delegated.cjs.map +1 -0
  101. package/dist/entry-authorization-delegated.d.cts +31 -0
  102. package/dist/entry-authorization-delegated.d.mts +31 -0
  103. package/dist/entry-authorization-delegated.mjs +26 -0
  104. package/dist/entry-authorization-delegated.mjs.map +1 -0
  105. package/dist/entry-authorization-none.cjs +3 -0
  106. package/dist/entry-authorization-none.d.cts +18 -0
  107. package/dist/entry-authorization-none.d.mts +18 -0
  108. package/dist/entry-authorization-none.mjs +2 -0
  109. package/dist/entry-authorization-roles.cjs +3 -0
  110. package/dist/entry-authorization-roles.d.cts +2 -0
  111. package/dist/entry-authorization-roles.d.mts +2 -0
  112. package/dist/entry-authorization-roles.mjs +2 -0
  113. package/dist/entry-authorization.cjs +35 -0
  114. package/dist/entry-authorization.cjs.map +1 -0
  115. package/dist/entry-authorization.d.cts +2 -0
  116. package/dist/entry-authorization.d.mts +2 -0
  117. package/dist/entry-authorization.mjs +34 -0
  118. package/dist/entry-authorization.mjs.map +1 -0
  119. package/dist/entry-build.cjs +481 -0
  120. package/dist/entry-build.cjs.map +1 -0
  121. package/dist/entry-build.d.cts +355 -0
  122. package/dist/entry-build.d.mts +355 -0
  123. package/dist/entry-build.mjs +460 -0
  124. package/dist/entry-build.mjs.map +1 -0
  125. package/dist/entry-cli.cjs +368 -0
  126. package/dist/entry-cli.cjs.map +1 -0
  127. package/dist/entry-cli.d.cts +275 -0
  128. package/dist/entry-cli.d.mts +275 -0
  129. package/dist/entry-cli.mjs +355 -0
  130. package/dist/entry-cli.mjs.map +1 -0
  131. package/dist/entry-drizzle-mysql.cjs +36 -0
  132. package/dist/entry-drizzle-mysql.cjs.map +1 -0
  133. package/dist/entry-drizzle-mysql.d.cts +55 -0
  134. package/dist/entry-drizzle-mysql.d.mts +55 -0
  135. package/dist/entry-drizzle-mysql.mjs +34 -0
  136. package/dist/entry-drizzle-mysql.mjs.map +1 -0
  137. package/dist/entry-drizzle-pg.cjs +38 -0
  138. package/dist/entry-drizzle-pg.cjs.map +1 -0
  139. package/dist/entry-drizzle-pg.d.cts +78 -0
  140. package/dist/entry-drizzle-pg.d.mts +78 -0
  141. package/dist/entry-drizzle-pg.mjs +36 -0
  142. package/dist/entry-drizzle-pg.mjs.map +1 -0
  143. package/dist/entry-drizzle-sqlite.cjs +20 -0
  144. package/dist/entry-drizzle-sqlite.cjs.map +1 -0
  145. package/dist/entry-drizzle-sqlite.d.cts +22 -0
  146. package/dist/entry-drizzle-sqlite.d.mts +22 -0
  147. package/dist/entry-drizzle-sqlite.mjs +19 -0
  148. package/dist/entry-drizzle-sqlite.mjs.map +1 -0
  149. package/dist/entry-hooks-log.cjs +32 -0
  150. package/dist/entry-hooks-log.cjs.map +1 -0
  151. package/dist/entry-hooks-log.d.cts +36 -0
  152. package/dist/entry-hooks-log.d.mts +36 -0
  153. package/dist/entry-hooks-log.mjs +31 -0
  154. package/dist/entry-hooks-log.mjs.map +1 -0
  155. package/dist/entry-hooks.cjs +10 -0
  156. package/dist/entry-hooks.d.cts +2 -0
  157. package/dist/entry-hooks.d.mts +2 -0
  158. package/dist/entry-hooks.mjs +2 -0
  159. package/dist/entry-server-router.cjs +235 -0
  160. package/dist/entry-server-router.cjs.map +1 -0
  161. package/dist/entry-server-router.d.cts +193 -0
  162. package/dist/entry-server-router.d.mts +193 -0
  163. package/dist/entry-server-router.mjs +228 -0
  164. package/dist/entry-server-router.mjs.map +1 -0
  165. package/dist/entry-server.cjs +344 -0
  166. package/dist/entry-server.cjs.map +1 -0
  167. package/dist/entry-server.d.cts +230 -0
  168. package/dist/entry-server.d.mts +230 -0
  169. package/dist/entry-server.mjs +322 -0
  170. package/dist/entry-server.mjs.map +1 -0
  171. package/dist/entry-site.cjs +1083 -0
  172. package/dist/entry-site.cjs.map +1 -0
  173. package/dist/entry-site.d.cts +336 -0
  174. package/dist/entry-site.d.mts +336 -0
  175. package/dist/entry-site.mjs +1060 -0
  176. package/dist/entry-site.mjs.map +1 -0
  177. package/dist/entry-storage-cloudflare-kv.cjs +51 -0
  178. package/dist/entry-storage-cloudflare-kv.cjs.map +1 -0
  179. package/dist/entry-storage-cloudflare-kv.d.cts +52 -0
  180. package/dist/entry-storage-cloudflare-kv.d.mts +52 -0
  181. package/dist/entry-storage-cloudflare-kv.mjs +50 -0
  182. package/dist/entry-storage-cloudflare-kv.mjs.map +1 -0
  183. package/dist/entry-storage-drizzle-internals.cjs +6 -0
  184. package/dist/entry-storage-drizzle-internals.d.cts +2 -0
  185. package/dist/entry-storage-drizzle-internals.d.mts +2 -0
  186. package/dist/entry-storage-drizzle-internals.mjs +2 -0
  187. package/dist/entry-storage-drizzle.cjs +4 -0
  188. package/dist/entry-storage-drizzle.d.cts +3 -0
  189. package/dist/entry-storage-drizzle.d.mts +3 -0
  190. package/dist/entry-storage-drizzle.mjs +2 -0
  191. package/dist/entry-storage-file.cjs +306 -0
  192. package/dist/entry-storage-file.cjs.map +1 -0
  193. package/dist/entry-storage-file.d.cts +76 -0
  194. package/dist/entry-storage-file.d.mts +76 -0
  195. package/dist/entry-storage-file.mjs +301 -0
  196. package/dist/entry-storage-file.mjs.map +1 -0
  197. package/dist/entry-storage-libsql-internals.cjs +7 -0
  198. package/dist/entry-storage-libsql-internals.d.cts +3 -0
  199. package/dist/entry-storage-libsql-internals.d.mts +3 -0
  200. package/dist/entry-storage-libsql-internals.mjs +3 -0
  201. package/dist/entry-storage-libsql.cjs +3 -0
  202. package/dist/entry-storage-libsql.d.cts +2 -0
  203. package/dist/entry-storage-libsql.d.mts +2 -0
  204. package/dist/entry-storage-libsql.mjs +2 -0
  205. package/dist/entry-storage-memory.cjs +78 -0
  206. package/dist/entry-storage-memory.cjs.map +1 -0
  207. package/dist/entry-storage-memory.d.cts +35 -0
  208. package/dist/entry-storage-memory.d.mts +35 -0
  209. package/dist/entry-storage-memory.mjs +77 -0
  210. package/dist/entry-storage-memory.mjs.map +1 -0
  211. package/dist/entry-storage-mongodb-internals.cjs +5 -0
  212. package/dist/entry-storage-mongodb-internals.d.cts +2 -0
  213. package/dist/entry-storage-mongodb-internals.d.mts +2 -0
  214. package/dist/entry-storage-mongodb-internals.mjs +2 -0
  215. package/dist/entry-storage-mongodb.cjs +3 -0
  216. package/dist/entry-storage-mongodb.d.cts +2 -0
  217. package/dist/entry-storage-mongodb.d.mts +2 -0
  218. package/dist/entry-storage-mongodb.mjs +2 -0
  219. package/dist/entry-storage-postgres-internals.cjs +6 -0
  220. package/dist/entry-storage-postgres-internals.d.cts +2 -0
  221. package/dist/entry-storage-postgres-internals.d.mts +2 -0
  222. package/dist/entry-storage-postgres-internals.mjs +2 -0
  223. package/dist/entry-storage-postgres.cjs +4 -0
  224. package/dist/entry-storage-postgres.d.cts +2 -0
  225. package/dist/entry-storage-postgres.d.mts +2 -0
  226. package/dist/entry-storage-postgres.mjs +2 -0
  227. package/dist/entry-storage-redis-internals.cjs +7 -0
  228. package/dist/entry-storage-redis-internals.d.cts +2 -0
  229. package/dist/entry-storage-redis-internals.d.mts +2 -0
  230. package/dist/entry-storage-redis-internals.mjs +2 -0
  231. package/dist/entry-storage-redis.cjs +4 -0
  232. package/dist/entry-storage-redis.d.cts +2 -0
  233. package/dist/entry-storage-redis.d.mts +2 -0
  234. package/dist/entry-storage-redis.mjs +2 -0
  235. package/dist/entry-storage-sqlite-internals.cjs +7 -0
  236. package/dist/entry-storage-sqlite-internals.d.cts +3 -0
  237. package/dist/entry-storage-sqlite-internals.d.mts +3 -0
  238. package/dist/entry-storage-sqlite-internals.mjs +3 -0
  239. package/dist/entry-storage-sqlite.cjs +3 -0
  240. package/dist/entry-storage-sqlite.d.cts +2 -0
  241. package/dist/entry-storage-sqlite.d.mts +2 -0
  242. package/dist/entry-storage-sqlite.mjs +2 -0
  243. package/dist/entry-storage-testing.cjs +801 -0
  244. package/dist/entry-storage-testing.cjs.map +1 -0
  245. package/dist/entry-storage-testing.d.cts +150 -0
  246. package/dist/entry-storage-testing.d.mts +150 -0
  247. package/dist/entry-storage-testing.mjs +790 -0
  248. package/dist/entry-storage-testing.mjs.map +1 -0
  249. package/dist/entry-storage-unstorage.cjs +78 -0
  250. package/dist/entry-storage-unstorage.cjs.map +1 -0
  251. package/dist/entry-storage-unstorage.d.cts +30 -0
  252. package/dist/entry-storage-unstorage.d.mts +30 -0
  253. package/dist/entry-storage-unstorage.mjs +77 -0
  254. package/dist/entry-storage-unstorage.mjs.map +1 -0
  255. package/dist/entry-storage.cjs +114 -0
  256. package/dist/entry-storage.cjs.map +1 -0
  257. package/dist/entry-storage.d.cts +152 -0
  258. package/dist/entry-storage.d.mts +152 -0
  259. package/dist/entry-storage.mjs +91 -0
  260. package/dist/entry-storage.mjs.map +1 -0
  261. package/dist/entry-testing.cjs +79 -0
  262. package/dist/entry-testing.cjs.map +1 -0
  263. package/dist/entry-testing.d.cts +55 -0
  264. package/dist/entry-testing.d.mts +55 -0
  265. package/dist/entry-testing.mjs +77 -0
  266. package/dist/entry-testing.mjs.map +1 -0
  267. package/dist/entry-tokens.cjs +4 -0
  268. package/dist/entry-tokens.d.cts +85 -0
  269. package/dist/entry-tokens.d.mts +85 -0
  270. package/dist/entry-tokens.mjs +2 -0
  271. package/dist/entry-ui-embed.cjs +131 -0
  272. package/dist/entry-ui-embed.cjs.map +1 -0
  273. package/dist/entry-ui-embed.d.cts +87 -0
  274. package/dist/entry-ui-embed.d.mts +87 -0
  275. package/dist/entry-ui-embed.mjs +127 -0
  276. package/dist/entry-ui-embed.mjs.map +1 -0
  277. package/dist/entry-ui.cjs +795 -0
  278. package/dist/entry-ui.cjs.map +1 -0
  279. package/dist/entry-ui.d.cts +574 -0
  280. package/dist/entry-ui.d.mts +574 -0
  281. package/dist/entry-ui.mjs +731 -0
  282. package/dist/entry-ui.mjs.map +1 -0
  283. package/dist/entry-util.cjs +145 -0
  284. package/dist/entry-util.cjs.map +1 -0
  285. package/dist/entry-util.d.cts +85 -0
  286. package/dist/entry-util.d.mts +85 -0
  287. package/dist/entry-util.mjs +130 -0
  288. package/dist/entry-util.mjs.map +1 -0
  289. package/dist/http-B_rTnLW9.cjs +235 -0
  290. package/dist/http-B_rTnLW9.cjs.map +1 -0
  291. package/dist/http-CxYM7kPT.d.mts +133 -0
  292. package/dist/http-DVdVI6kJ.mjs +164 -0
  293. package/dist/http-DVdVI6kJ.mjs.map +1 -0
  294. package/dist/http-XBVRk8uo.d.cts +133 -0
  295. package/dist/index.cjs +8 -0
  296. package/dist/index.cjs.map +1 -0
  297. package/dist/index.d.cts +6 -0
  298. package/dist/index.d.mts +6 -0
  299. package/dist/index.mjs +7 -0
  300. package/dist/index.mjs.map +1 -0
  301. package/dist/json-CCyzstIm.d.cts +44 -0
  302. package/dist/json-CCyzstIm.d.mts +44 -0
  303. package/dist/json-CM7TwYQ7.cjs +92 -0
  304. package/dist/json-CM7TwYQ7.cjs.map +1 -0
  305. package/dist/json-CmM1M5Kz.mjs +63 -0
  306. package/dist/json-CmM1M5Kz.mjs.map +1 -0
  307. package/dist/keys-Bwubabk0.mjs +73 -0
  308. package/dist/keys-Bwubabk0.mjs.map +1 -0
  309. package/dist/keys-DQrwxDKI.cjs +126 -0
  310. package/dist/keys-DQrwxDKI.cjs.map +1 -0
  311. package/dist/kv-sqlite-B6iTLOx2.d.cts +20 -0
  312. package/dist/kv-sqlite-CHOdIMJ-.cjs +77 -0
  313. package/dist/kv-sqlite-CHOdIMJ-.cjs.map +1 -0
  314. package/dist/kv-sqlite-DIIPfflJ.mjs +66 -0
  315. package/dist/kv-sqlite-DIIPfflJ.mjs.map +1 -0
  316. package/dist/kv-sqlite-Tx4UedJs.d.mts +20 -0
  317. package/dist/libsql-0160BubR.d.mts +65 -0
  318. package/dist/libsql-BZmRZIqt.d.cts +65 -0
  319. package/dist/libsql-CiBfVtbS.cjs +103 -0
  320. package/dist/libsql-CiBfVtbS.cjs.map +1 -0
  321. package/dist/libsql-CkOjQINi.mjs +86 -0
  322. package/dist/libsql-CkOjQINi.mjs.map +1 -0
  323. package/dist/mongodb--Cuj7V_9.cjs +150 -0
  324. package/dist/mongodb--Cuj7V_9.cjs.map +1 -0
  325. package/dist/mongodb-DGtsolQ2.d.cts +61 -0
  326. package/dist/mongodb-JMizy4Wg.mjs +127 -0
  327. package/dist/mongodb-JMizy4Wg.mjs.map +1 -0
  328. package/dist/mongodb-xGEU5Gwz.d.mts +61 -0
  329. package/dist/node-B1Djcwfi.d.cts +57 -0
  330. package/dist/node-B1Djcwfi.d.mts +57 -0
  331. package/dist/node-BYjocCbU.mjs +167 -0
  332. package/dist/node-BYjocCbU.mjs.map +1 -0
  333. package/dist/node-DFFqYRk-.cjs +201 -0
  334. package/dist/node-DFFqYRk-.cjs.map +1 -0
  335. package/dist/none-BEY7Kc_-.mjs +33 -0
  336. package/dist/none-BEY7Kc_-.mjs.map +1 -0
  337. package/dist/none-BoQ6-30P.cjs +33 -0
  338. package/dist/none-BoQ6-30P.cjs.map +1 -0
  339. package/dist/none-CHwVkQL-.cjs +49 -0
  340. package/dist/none-CHwVkQL-.cjs.map +1 -0
  341. package/dist/none-yu3qC47E.mjs +23 -0
  342. package/dist/none-yu3qC47E.mjs.map +1 -0
  343. package/dist/peer-BIjBFzwQ.cjs +56 -0
  344. package/dist/peer-BIjBFzwQ.cjs.map +1 -0
  345. package/dist/peer-CTHMzOdn.mjs +40 -0
  346. package/dist/peer-CTHMzOdn.mjs.map +1 -0
  347. package/dist/portal-container-CJIcau3B.mjs +610 -0
  348. package/dist/portal-container-CJIcau3B.mjs.map +1 -0
  349. package/dist/portal-container-Ca1NxrLE.cjs +774 -0
  350. package/dist/portal-container-Ca1NxrLE.cjs.map +1 -0
  351. package/dist/postgres-BJzxKBk0.d.cts +72 -0
  352. package/dist/postgres-CA8_XcAE.cjs +164 -0
  353. package/dist/postgres-CA8_XcAE.cjs.map +1 -0
  354. package/dist/postgres-RfQMgAsj.d.mts +72 -0
  355. package/dist/postgres-aDiBmNzr.mjs +135 -0
  356. package/dist/postgres-aDiBmNzr.mjs.map +1 -0
  357. package/dist/redis-B2AS4xAQ.cjs +259 -0
  358. package/dist/redis-B2AS4xAQ.cjs.map +1 -0
  359. package/dist/redis-B362ofBw.d.cts +159 -0
  360. package/dist/redis-CahNAVTW.d.mts +159 -0
  361. package/dist/redis-hdoKymfG.mjs +218 -0
  362. package/dist/redis-hdoKymfG.mjs.map +1 -0
  363. package/dist/roles-7JPrQXZa.mjs +46 -0
  364. package/dist/roles-7JPrQXZa.mjs.map +1 -0
  365. package/dist/roles-B_8QqJ3j.cjs +56 -0
  366. package/dist/roles-B_8QqJ3j.cjs.map +1 -0
  367. package/dist/roles-DLISB4T3.d.mts +41 -0
  368. package/dist/roles-DQbbtUPW.d.cts +41 -0
  369. package/dist/rolldown-runtime-D7D4PA-g.mjs +13 -0
  370. package/dist/scope-css-BN3jf0ly.cjs +315 -0
  371. package/dist/scope-css-BN3jf0ly.cjs.map +1 -0
  372. package/dist/scope-css-BuJfRCsE.mjs +256 -0
  373. package/dist/scope-css-BuJfRCsE.mjs.map +1 -0
  374. package/dist/scoped-BRoE1W1x.cjs +175 -0
  375. package/dist/scoped-BRoE1W1x.cjs.map +1 -0
  376. package/dist/scoped-cFBbotCh.mjs +164 -0
  377. package/dist/scoped-cFBbotCh.mjs.map +1 -0
  378. package/dist/sqlite-B2g1JJz1.d.cts +47 -0
  379. package/dist/sqlite-BIPIlxfj.d.mts +47 -0
  380. package/dist/sqlite-BntoYaXZ.cjs +79 -0
  381. package/dist/sqlite-BntoYaXZ.cjs.map +1 -0
  382. package/dist/sqlite-DYJDcu7p.mjs +62 -0
  383. package/dist/sqlite-DYJDcu7p.mjs.map +1 -0
  384. package/dist/table-BrioFSra.d.cts +11 -0
  385. package/dist/table-BrioFSra.d.mts +11 -0
  386. package/dist/theme-context-DzZ1otaD.d.cts +270 -0
  387. package/dist/theme-context-J65pythD.d.mts +270 -0
  388. package/dist/ui/styles.css +239 -0
  389. package/dist/util-Dnj5T-yw.mjs +39 -0
  390. package/dist/util-Dnj5T-yw.mjs.map +1 -0
  391. package/dist/util-dAnTK9x-.cjs +74 -0
  392. package/dist/util-dAnTK9x-.cjs.map +1 -0
  393. package/dist/validation-B-atP968.mjs +191 -0
  394. package/dist/validation-B-atP968.mjs.map +1 -0
  395. package/dist/validation-BJifGoB2.d.mts +122 -0
  396. package/dist/validation-DLnzBVJr.cjs +258 -0
  397. package/dist/validation-DLnzBVJr.cjs.map +1 -0
  398. package/dist/validation-tfV2qhbD.d.cts +122 -0
  399. package/package.json +715 -4
  400. package/tsconfig/assets.d.ts +21 -0
  401. package/tsconfig/base.json +21 -0
  402. package/tsconfig/react.json +9 -0
@@ -0,0 +1,801 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_keys = require("./keys-DQrwxDKI.cjs");
3
+ //#region src/storage/testing/conformance.ts
4
+ /**
5
+ * The shared storage conformance suite (ADR 0006). The test API is injected, so the suite runs under
6
+ * vitest, `bun:test` or anything with the same `describe` / `test` / `expect` shape; nothing here
7
+ * imports a test runner.
8
+ *
9
+ * The cases are the union of the products' suites plus the regression cases for every storage fix
10
+ * the kit carries (empty segments, `$` / `#` / unicode keys, many keys, SCAN duplicates, `PSUBSCRIBE`
11
+ * with glob characters, concurrent CAS, `{}` vs `[]`, legacy non-canonical values).
12
+ *
13
+ * @module
14
+ */
15
+ /** Resolve after `ms` milliseconds. */
16
+ const settle = (ms) => new Promise((r) => setTimeout(r, ms));
17
+ /** Narrow to {@link CompareAndSwapKvStorage} or throw a clear error. */
18
+ function requireCompareAndSwap(storage) {
19
+ if (!require_keys.isCompareAndSwap(storage)) throw new Error("storage has no compareAndSwap capability");
20
+ return storage;
21
+ }
22
+ /** Narrow to {@link WatchableKvStorage} or throw a clear error. */
23
+ function requireWatchable(storage) {
24
+ if (!require_keys.isWatchable(storage)) throw new Error("storage has no watch capability");
25
+ return storage;
26
+ }
27
+ const sorted = (keys) => [...keys].sort();
28
+ /**
29
+ * Register `describe(title, …)` with one test per case. Each test gets a fresh storage from `make`.
30
+ * This is how products register their own extra suites next to {@link runStorageConformance}.
31
+ */
32
+ function runConformanceCases(title, cases, make, options) {
33
+ const { t, keyRoot = "kit", timeout } = options;
34
+ t.describe(title, () => {
35
+ for (const c of cases) t.test(c.name, async () => {
36
+ const storage = await make();
37
+ try {
38
+ await c.run({
39
+ storage,
40
+ key: (...segments) => [keyRoot, ...segments].join("/"),
41
+ expect: t.expect,
42
+ settle,
43
+ options
44
+ });
45
+ } finally {
46
+ await storage.close?.();
47
+ }
48
+ }, timeout);
49
+ });
50
+ }
51
+ /** The base-contract cases every driver must pass. */
52
+ const contractCases = [
53
+ {
54
+ name: "returns null for a missing key",
55
+ async run({ storage, key, expect }) {
56
+ expect(await storage.getItem(key("missing"))).toBeNull();
57
+ }
58
+ },
59
+ {
60
+ name: "round-trips objects, arrays, primitives and empty containers",
61
+ async run({ storage, key, expect }) {
62
+ const values = {
63
+ object: {
64
+ url: "https://x.example/a?b=1",
65
+ tags: ["a", "b"],
66
+ nested: {
67
+ x: 1,
68
+ y: null
69
+ }
70
+ },
71
+ array: ["a", { b: [1, 2] }],
72
+ string: "hello",
73
+ number: 42.5,
74
+ zero: 0,
75
+ boolTrue: true,
76
+ boolFalse: false,
77
+ emptyObject: {},
78
+ emptyArray: []
79
+ };
80
+ for (const [k, v] of Object.entries(values)) await storage.setItem(key("v", k), v);
81
+ for (const [k, v] of Object.entries(values)) expect(await storage.getItem(key("v", k))).toEqual(v);
82
+ expect(Array.isArray(await storage.getItem(key("v", "emptyArray")))).toBe(true);
83
+ expect(Array.isArray(await storage.getItem(key("v", "emptyObject")))).toBe(false);
84
+ }
85
+ },
86
+ {
87
+ name: "strings that look like JSON stay strings",
88
+ async run({ storage, key, expect }) {
89
+ const values = [
90
+ "123",
91
+ "true",
92
+ "null",
93
+ "{\"a\":1}",
94
+ "\"quoted\"",
95
+ "[1]",
96
+ ""
97
+ ];
98
+ for (const [i, v] of values.entries()) await storage.setItem(key("str", String(i)), v);
99
+ for (const [i, v] of values.entries()) expect(await storage.getItem(key("str", String(i)))).toBe(v);
100
+ }
101
+ },
102
+ {
103
+ name: "overwrites an existing key",
104
+ async run({ storage, key, expect }) {
105
+ await storage.setItem(key("k"), { v: 1 });
106
+ await storage.setItem(key("k"), { v: 2 });
107
+ expect(await storage.getItem(key("k"))).toEqual({ v: 2 });
108
+ }
109
+ },
110
+ {
111
+ name: "removeItem deletes a key; removing a missing key is a no-op",
112
+ async run({ storage, key, expect }) {
113
+ await storage.setItem(key("k"), { v: 1 });
114
+ await storage.removeItem(key("k"));
115
+ expect(await storage.getItem(key("k"))).toBeNull();
116
+ expect(await storage.getKeys(key(""))).toEqual([]);
117
+ expect(await storage.removeItem(key("nope"))).toBe(void 0);
118
+ }
119
+ },
120
+ {
121
+ name: "getKeys lists nested keys under a prefix, isolated from sibling prefixes",
122
+ async run({ storage, key, expect }) {
123
+ await storage.setItem(key("app1", "a"), 1);
124
+ await storage.setItem(key("app1", "deep", "b"), 2);
125
+ await storage.setItem(key("app10", "c"), 3);
126
+ expect(sorted(await storage.getKeys(key("app1", "")))).toEqual(sorted([key("app1", "a"), key("app1", "deep", "b")]));
127
+ expect(await storage.getKeys(key("app10", ""))).toEqual([key("app10", "c")]);
128
+ expect(sorted(await storage.getKeys(key("app1")))).toEqual(sorted([
129
+ key("app1", "a"),
130
+ key("app1", "deep", "b"),
131
+ key("app10", "c")
132
+ ]));
133
+ expect(await storage.getKeys(key("nothing", ""))).toEqual([]);
134
+ }
135
+ },
136
+ {
137
+ name: "keys are case- and accent-sensitive (no collation folding)",
138
+ async run({ storage, key, expect }) {
139
+ await storage.setItem(key("t", "Acme", "x"), { v: "upper" });
140
+ await storage.setItem(key("t", "acme", "x"), { v: "lower" });
141
+ await storage.setItem(key("t", "acmé", "x"), { v: "accent" });
142
+ expect(await storage.getItem(key("t", "Acme", "x"))).toEqual({ v: "upper" });
143
+ expect(await storage.getItem(key("t", "acme", "x"))).toEqual({ v: "lower" });
144
+ expect(await storage.getItem(key("t", "acmé", "x"))).toEqual({ v: "accent" });
145
+ expect(await storage.getItem(key("t", "ACME", "x"))).toBeNull();
146
+ expect(await storage.getKeys(key("t", "Acme", ""))).toEqual([key("t", "Acme", "x")]);
147
+ expect(await storage.getKeys(key("t", "acme", ""))).toEqual([key("t", "acme", "x")]);
148
+ expect(await storage.getKeys(key("t", "A"))).toEqual([key("t", "Acme", "x")]);
149
+ await storage.removeItem(key("t", "ACME", "x"));
150
+ expect(await storage.getItem(key("t", "Acme", "x"))).toEqual({ v: "upper" });
151
+ }
152
+ },
153
+ {
154
+ name: "case-distinct tenants are isolated",
155
+ async run({ storage, key, expect }) {
156
+ for (const tenant of [
157
+ "Acme",
158
+ "acme",
159
+ "ACME"
160
+ ]) {
161
+ await storage.setItem(key("tenant", tenant, "item"), { tenant });
162
+ await storage.setItem(key("tenants", tenant), tenant);
163
+ }
164
+ for (const tenant of [
165
+ "Acme",
166
+ "acme",
167
+ "ACME"
168
+ ]) {
169
+ expect(await storage.getItem(key("tenant", tenant, "item"))).toEqual({ tenant });
170
+ expect(await storage.getKeys(key("tenant", tenant, ""))).toEqual([key("tenant", tenant, "item")]);
171
+ }
172
+ expect(sorted(await storage.getKeys(key("tenants", "")))).toEqual(sorted([
173
+ "Acme",
174
+ "acme",
175
+ "ACME"
176
+ ].map((t) => key("tenants", t))));
177
+ }
178
+ },
179
+ {
180
+ name: "LIKE / GLOB / Redis-glob / unstorage metacharacters in keys and prefixes are literal",
181
+ async run({ storage, key, expect }) {
182
+ const specials = [
183
+ "%",
184
+ "_",
185
+ "!",
186
+ "\\",
187
+ "*",
188
+ "?",
189
+ "[",
190
+ "]",
191
+ ":",
192
+ "%25",
193
+ "#",
194
+ "$",
195
+ "[x]"
196
+ ];
197
+ const keys = specials.map((c) => key(`x${c}y`, "a"));
198
+ keys.push(key("xzy", "a"), key("xay", "a"), key("x", "y", "a"), key("xy", "a"));
199
+ for (const k of keys) await storage.setItem(k, { k });
200
+ for (const k of keys) expect(await storage.getItem(k)).toEqual({ k });
201
+ for (const c of specials) {
202
+ expect(sorted(await storage.getKeys(key(`x${c}y`, "")))).toEqual(keys.filter((k) => k.startsWith(key(`x${c}y`, ""))));
203
+ expect(sorted(await storage.getKeys(key(`x${c}`)))).toEqual(sorted(keys.filter((k) => k.startsWith(key(`x${c}`)))));
204
+ }
205
+ expect(sorted(await storage.getKeys(key("x")))).toEqual(sorted(keys));
206
+ }
207
+ },
208
+ {
209
+ name: "keys with ? \\ ] : # % %25 stay distinct (no normalization)",
210
+ async run({ storage, key, expect }) {
211
+ const keys = [
212
+ "a?b",
213
+ "ab",
214
+ "a\\b",
215
+ "a:b",
216
+ "a]b",
217
+ "a#b",
218
+ "a%b",
219
+ "a%25b",
220
+ "a/b"
221
+ ].map((s) => key("s", s));
222
+ for (const [i, k] of keys.entries()) await storage.setItem(k, { i });
223
+ for (const [i, k] of keys.entries()) expect(await storage.getItem(k)).toEqual({ i });
224
+ expect(sorted(await storage.getKeys(key("s", "")))).toEqual(sorted(keys));
225
+ expect(await storage.getKeys(key("s", "a?"))).toEqual([key("s", "a?b")]);
226
+ expect(await storage.getKeys(key("s", "a%25"))).toEqual([key("s", "a%25b")]);
227
+ expect(await storage.getItem(key("s", "a%b"))).toEqual({ i: 6 });
228
+ }
229
+ },
230
+ {
231
+ name: "keys with $ (trailing, inner, alone) round-trip and are listed",
232
+ async run({ storage, key, expect }) {
233
+ const keys = [
234
+ key("d", "end$"),
235
+ key("d", "a$b"),
236
+ key("d", "$"),
237
+ key("d$", "x"),
238
+ key("d", "$$")
239
+ ];
240
+ for (const [i, k] of keys.entries()) await storage.setItem(k, i);
241
+ for (const [i, k] of keys.entries()) expect(await storage.getItem(k)).toBe(i);
242
+ expect(sorted(await storage.getKeys(key("d")))).toEqual(sorted(keys));
243
+ expect(await storage.getKeys(key("d$", ""))).toEqual([key("d$", "x")]);
244
+ await storage.removeItem(key("d", "end$"));
245
+ expect(await storage.getItem(key("d", "end$"))).toBeNull();
246
+ }
247
+ },
248
+ {
249
+ name: "keys differing only by trailing spaces stay distinct",
250
+ async run({ storage, key, expect }) {
251
+ const keys = [
252
+ key("sp", "a"),
253
+ key("sp", "a "),
254
+ key("sp", "a "),
255
+ key("sp", "a", " ")
256
+ ];
257
+ for (const [i, k] of keys.entries()) await storage.setItem(k, { i });
258
+ for (const [i, k] of keys.entries()) expect(await storage.getItem(k)).toEqual({ i });
259
+ expect(sorted(await storage.getKeys(key("sp", "")))).toEqual(sorted(keys));
260
+ expect(sorted(await storage.getKeys(key("sp", "a ")))).toEqual(sorted([key("sp", "a "), key("sp", "a ")]));
261
+ await storage.removeItem(key("sp", "a "));
262
+ expect(await storage.getItem(key("sp", "a"))).toEqual({ i: 0 });
263
+ expect(await storage.getItem(key("sp", "a "))).toBeNull();
264
+ }
265
+ },
266
+ {
267
+ name: "unicode keys (emoji, CJK, NFC ≠ NFD) round-trip and stay distinct",
268
+ async run({ storage, key, expect }) {
269
+ const keys = [
270
+ key("u", "🚀"),
271
+ key("u", "日本語"),
272
+ key("u", "café"),
273
+ key("u", "café"),
274
+ key("u", "cafe")
275
+ ];
276
+ for (const [i, k] of keys.entries()) await storage.setItem(k, { i });
277
+ for (const [i, k] of keys.entries()) expect(await storage.getItem(k)).toEqual({ i });
278
+ expect(sorted(await storage.getKeys(key("u", "")))).toEqual(sorted(keys));
279
+ expect(await storage.getKeys(key("u", "日"))).toEqual([key("u", "日本語")]);
280
+ }
281
+ },
282
+ {
283
+ name: "empty key segments are distinct keys (a//b ≠ a/b, trailing /)",
284
+ async run({ storage, key, expect }) {
285
+ const keys = [
286
+ key("e", "", "b"),
287
+ key("e", "b"),
288
+ key("e", ""),
289
+ key("e", "x", ""),
290
+ key("e", "x")
291
+ ];
292
+ for (const [i, k] of keys.entries()) await storage.setItem(k, { i });
293
+ for (const [i, k] of keys.entries()) expect(await storage.getItem(k)).toEqual({ i });
294
+ expect(sorted(await storage.getKeys(key("e", "")))).toEqual(sorted(keys));
295
+ expect(await storage.getKeys(key("e", "", ""))).toEqual([key("e", "", "b")]);
296
+ expect(sorted(await storage.getKeys(key("e", "x")))).toEqual(sorted([key("e", "x", ""), key("e", "x")]));
297
+ await storage.removeItem(key("e", "", "b"));
298
+ expect(await storage.getItem(key("e", "b"))).toEqual({ i: 1 });
299
+ }
300
+ },
301
+ {
302
+ name: "zero-padded sortable leaves list in chronological order once sorted",
303
+ async run({ storage, key, expect }) {
304
+ const times = [
305
+ 1700000000123,
306
+ 5,
307
+ 1700000000122,
308
+ 99999,
309
+ 16e11
310
+ ];
311
+ for (const [i, ms] of times.entries()) await storage.setItem(key("due", require_keys.sortableLeaf(ms, `id${i}`)), i);
312
+ expect(sorted(await storage.getKeys(key("due", "")))).toEqual([...times.entries()].sort(([, a], [, b]) => a - b).map(([i, ms]) => key("due", require_keys.sortableLeaf(ms, `id${i}`))));
313
+ }
314
+ },
315
+ {
316
+ name: "lists many keys (pagination) without duplicates",
317
+ async run({ storage, key, expect }) {
318
+ const keys = Array.from({ length: 250 }, (_, i) => key("bulk", String(i).padStart(3, "0")));
319
+ await Promise.all(keys.map((k, i) => storage.setItem(k, { i })));
320
+ const listed = await storage.getKeys(key("bulk", ""));
321
+ expect(listed.length).toBe(250);
322
+ expect(new Set(listed).size).toBe(250);
323
+ expect(sorted(listed)).toEqual(keys);
324
+ }
325
+ }
326
+ ];
327
+ /** The compare-and-swap cases (`capabilities.compareAndSwap`). */
328
+ const compareAndSwapCases = [
329
+ {
330
+ name: "swaps only when the expectation holds (absence, mismatch, match)",
331
+ async run({ storage, key, expect }) {
332
+ const cas = requireCompareAndSwap(storage);
333
+ const k = key("cas");
334
+ expect(await cas.compareAndSwap({
335
+ key: k,
336
+ expected: { v: 1 },
337
+ next: { v: 2 }
338
+ })).toBe(false);
339
+ expect(await cas.getItem(k)).toBeNull();
340
+ expect(await cas.compareAndSwap({
341
+ key: k,
342
+ expected: null,
343
+ next: {
344
+ v: 1,
345
+ tags: ["a"]
346
+ }
347
+ })).toBe(true);
348
+ expect(await cas.compareAndSwap({
349
+ key: k,
350
+ expected: null,
351
+ next: { v: 9 }
352
+ })).toBe(false);
353
+ expect(await cas.compareAndSwap({
354
+ key: k,
355
+ expected: { v: 0 },
356
+ next: { v: 2 }
357
+ })).toBe(false);
358
+ expect(await cas.compareAndSwap({
359
+ key: k,
360
+ expected: { v: 1 },
361
+ next: { v: 2 }
362
+ })).toBe(false);
363
+ expect(await cas.compareAndSwap({
364
+ key: k,
365
+ expected: {
366
+ v: 1,
367
+ tags: ["a"]
368
+ },
369
+ next: { v: 2 }
370
+ })).toBe(true);
371
+ expect(await cas.getItem(k)).toEqual({ v: 2 });
372
+ }
373
+ },
374
+ {
375
+ name: "compares structurally: object key order is ignored, arrays are ordered",
376
+ async run({ storage, key, expect }) {
377
+ const cas = requireCompareAndSwap(storage);
378
+ const k = key("order");
379
+ await cas.setItem(k, {
380
+ b: 1,
381
+ a: {
382
+ d: [1, 2],
383
+ c: null
384
+ }
385
+ });
386
+ expect(await cas.compareAndSwap({
387
+ key: k,
388
+ expected: {
389
+ a: {
390
+ c: null,
391
+ d: [2, 1]
392
+ },
393
+ b: 1
394
+ },
395
+ next: 0
396
+ })).toBe(false);
397
+ expect(await cas.compareAndSwap({
398
+ key: k,
399
+ expected: {
400
+ a: {
401
+ c: null,
402
+ d: [1, 2]
403
+ },
404
+ b: 1
405
+ },
406
+ next: { n: 1 }
407
+ })).toBe(true);
408
+ expect(await cas.getItem(k)).toEqual({ n: 1 });
409
+ }
410
+ },
411
+ {
412
+ name: "{} and [] are different values",
413
+ async run({ storage, key, expect }) {
414
+ const cas = requireCompareAndSwap(storage);
415
+ await cas.setItem(key("obj"), {});
416
+ await cas.setItem(key("arr"), []);
417
+ expect(await cas.compareAndSwap({
418
+ key: key("obj"),
419
+ expected: [],
420
+ next: 1
421
+ })).toBe(false);
422
+ expect(await cas.compareAndSwap({
423
+ key: key("arr"),
424
+ expected: {},
425
+ next: 1
426
+ })).toBe(false);
427
+ expect(await cas.compareAndSwap({
428
+ key: key("obj"),
429
+ expected: {},
430
+ next: 2
431
+ })).toBe(true);
432
+ expect(await cas.compareAndSwap({
433
+ key: key("arr"),
434
+ expected: [],
435
+ next: 3
436
+ })).toBe(true);
437
+ expect(await cas.getItem(key("obj"))).toBe(2);
438
+ expect(await cas.getItem(key("arr"))).toBe(3);
439
+ }
440
+ },
441
+ {
442
+ name: "swaps primitives",
443
+ async run({ storage, key, expect }) {
444
+ const cas = requireCompareAndSwap(storage);
445
+ await cas.setItem(key("p"), "a");
446
+ expect(await cas.compareAndSwap({
447
+ key: key("p"),
448
+ expected: "b",
449
+ next: "c"
450
+ })).toBe(false);
451
+ expect(await cas.compareAndSwap({
452
+ key: key("p"),
453
+ expected: "a",
454
+ next: 7
455
+ })).toBe(true);
456
+ expect(await cas.compareAndSwap({
457
+ key: key("p"),
458
+ expected: 7,
459
+ next: false
460
+ })).toBe(true);
461
+ expect(await cas.getItem(key("p"))).toBe(false);
462
+ }
463
+ },
464
+ {
465
+ name: "concurrent claims of an absent key: exactly one wins",
466
+ async run({ storage, key, expect }) {
467
+ const cas = requireCompareAndSwap(storage);
468
+ const results = await Promise.all(Array.from({ length: 8 }, (_, i) => cas.compareAndSwap({
469
+ key: key("claim"),
470
+ expected: null,
471
+ next: { by: i }
472
+ })));
473
+ expect(results.filter(Boolean).length).toBe(1);
474
+ const winner = results.indexOf(true);
475
+ expect(await cas.getItem(key("claim"))).toEqual({ by: winner });
476
+ }
477
+ },
478
+ {
479
+ name: "concurrent swaps from the same expectation: exactly one wins",
480
+ async run({ storage, key, expect }) {
481
+ const cas = requireCompareAndSwap(storage);
482
+ await cas.setItem(key("race"), {
483
+ n: 0,
484
+ meta: {
485
+ b: 1,
486
+ a: 2
487
+ }
488
+ });
489
+ expect((await Promise.all(Array.from({ length: 8 }, (_, i) => cas.compareAndSwap({
490
+ key: key("race"),
491
+ expected: {
492
+ meta: {
493
+ a: 2,
494
+ b: 1
495
+ },
496
+ n: 0
497
+ },
498
+ next: { n: i + 1 }
499
+ })))).filter(Boolean).length).toBe(1);
500
+ }
501
+ },
502
+ {
503
+ name: "legacy non-canonical stored values: read, listed and swapped (ADR 0005)",
504
+ async run({ storage, key, expect, options }) {
505
+ const seed = options.seedLegacy;
506
+ if (!seed) return;
507
+ const cas = requireCompareAndSwap(storage);
508
+ const k = key("legacy", "v");
509
+ const value = {
510
+ b: 1,
511
+ a: {
512
+ d: [1, {
513
+ z: 1,
514
+ y: 2
515
+ }],
516
+ c: "x"
517
+ }
518
+ };
519
+ await seed(storage, k, "{\"b\":1,\"a\":{\"d\":[1,{\"z\":1,\"y\":2}],\"c\":\"x\"}}");
520
+ expect(await cas.getItem(k)).toEqual(value);
521
+ expect(await cas.getKeys(key("legacy", ""))).toEqual([k]);
522
+ expect(await cas.compareAndSwap({
523
+ key: k,
524
+ expected: { b: 2 },
525
+ next: 0
526
+ })).toBe(false);
527
+ expect(await cas.compareAndSwap({
528
+ key: k,
529
+ expected: null,
530
+ next: 0
531
+ })).toBe(false);
532
+ expect(await cas.compareAndSwap({
533
+ key: k,
534
+ expected: value,
535
+ next: { n: 1 }
536
+ })).toBe(true);
537
+ expect(await cas.getItem(k)).toEqual({ n: 1 });
538
+ const k2 = key("legacy", "race");
539
+ await seed(storage, k2, "{\"b\":1,\"a\":2}");
540
+ expect((await Promise.all(Array.from({ length: 6 }, (_, i) => cas.compareAndSwap({
541
+ key: k2,
542
+ expected: {
543
+ a: 2,
544
+ b: 1
545
+ },
546
+ next: { i }
547
+ })))).filter(Boolean).length).toBe(1);
548
+ }
549
+ }
550
+ ];
551
+ /** The watch cases (`capabilities.watch`). */
552
+ const watchCases = [
553
+ {
554
+ name: "notifies updates and removals under the prefix only",
555
+ async run({ storage, key, expect, settle, options }) {
556
+ const ms = settleMs(options);
557
+ const watchable = requireWatchable(storage);
558
+ const events = [];
559
+ const off = await watchable.watch(key("w", ""), (e) => events.push(e));
560
+ await settle(ms);
561
+ await watchable.setItem(key("w", "a"), { v: 1 });
562
+ await watchable.setItem(key("other", "b"), { v: 1 });
563
+ await settle(ms);
564
+ const beforeRemove = events.length;
565
+ await watchable.removeItem(key("w", "a"));
566
+ await settle(ms);
567
+ await off();
568
+ expect(events.some((e) => e.type === "update" && e.key === key("w", "a"))).toBe(true);
569
+ if (reportsRemovals(options)) expect(events.some((e) => e.type === "remove" && e.key === key("w", "a"))).toBe(true);
570
+ else expect(events.slice(beforeRemove).some((e) => e.key === key("w", "a"))).toBe(true);
571
+ expect(events.every((e) => e.key.startsWith(key("w", "")))).toBe(true);
572
+ }
573
+ },
574
+ {
575
+ name: "a prefix with glob characters ([ ] * ? \\) matches literally",
576
+ async run({ storage, key, expect, settle, options }) {
577
+ const ms = settleMs(options);
578
+ const watchable = requireWatchable(storage);
579
+ const prefix = key("g[x]*?\\", "");
580
+ const events = [];
581
+ const off = await watchable.watch(prefix, (e) => events.push(e));
582
+ await settle(ms);
583
+ await watchable.setItem(`${prefix}a`, 1);
584
+ await watchable.setItem(key("gx", "b"), 1);
585
+ await settle(ms);
586
+ await off();
587
+ expect(events.some((e) => e.type === "update" && e.key === `${prefix}a`)).toBe(true);
588
+ expect(events.every((e) => e.key.startsWith(prefix))).toBe(true);
589
+ }
590
+ },
591
+ {
592
+ name: "unsubscribe stops notifications",
593
+ async run({ storage, key, expect, settle, options }) {
594
+ const ms = settleMs(options);
595
+ const watchable = requireWatchable(storage);
596
+ const events = [];
597
+ const off = await watchable.watch(key("off", ""), (e) => events.push(e));
598
+ await settle(ms);
599
+ await off();
600
+ await settle(ms);
601
+ await watchable.setItem(key("off", "a"), 1);
602
+ await settle(ms);
603
+ expect(events.length).toBe(0);
604
+ }
605
+ }
606
+ ];
607
+ /**
608
+ * The declared capabilities match the storage: an undeclared `compareAndSwap` or `watch` would skip
609
+ * those cases silently, and a declared one the storage lacks would fail them obscurely.
610
+ */
611
+ const capabilitiesCase = {
612
+ name: "declared capabilities match the storage",
613
+ async run({ storage, expect, options }) {
614
+ const declared = options.capabilities ?? {};
615
+ const problems = [];
616
+ const check = (name, has) => {
617
+ const value = declared[name];
618
+ if (value === void 0 && has) problems.push(`implements ${name} but capabilities.${name} is not declared (true to run its cases, false to skip)`);
619
+ else if (value && !has) problems.push(`declares capabilities.${name} but does not implement it`);
620
+ };
621
+ check("compareAndSwap", require_keys.isCompareAndSwap(storage));
622
+ check("watch", require_keys.isWatchable(storage));
623
+ expect(problems).toEqual([]);
624
+ }
625
+ };
626
+ const settleMs = (options) => {
627
+ const watch = options.capabilities?.watch;
628
+ return typeof watch === "object" ? watch.settleMs ?? 50 : 50;
629
+ };
630
+ const reportsRemovals = (options) => {
631
+ const watch = options.capabilities?.watch;
632
+ return typeof watch === "object" ? watch.removals !== false : true;
633
+ };
634
+ /**
635
+ * Register the full conformance suite for one driver: the base contract, plus the
636
+ * compare-and-swap and watch cases when `capabilities` says the driver has them.
637
+ *
638
+ * @example
639
+ * ```ts
640
+ * import { describe, expect, test } from "vitest"; // or "bun:test"
641
+ * import { runStorageConformance } from "@xtandard/kit/storage/testing";
642
+ * import { createMemoryStorage } from "@xtandard/kit/storage/memory";
643
+ *
644
+ * runStorageConformance("memory", () => createMemoryStorage(), {
645
+ * t: { describe, test, expect },
646
+ * capabilities: { compareAndSwap: true, watch: true },
647
+ * keyRoot: "whk",
648
+ * });
649
+ * ```
650
+ */
651
+ function runStorageConformance(name, make, options) {
652
+ runConformanceCases(`KvStorage contract: ${name}`, [capabilitiesCase, ...contractCases], make, options);
653
+ if (options.capabilities?.compareAndSwap) runConformanceCases(`compareAndSwap: ${name}`, compareAndSwapCases, make, options);
654
+ if (options.capabilities?.watch) runConformanceCases(`watch: ${name}`, watchCases, make, options);
655
+ }
656
+ //#endregion
657
+ //#region src/storage/testing/fake-redis.ts
658
+ /** Redis glob → RegExp (backslash escapes, `*`, `?`, `[…]`). */
659
+ function globToRegExp(glob) {
660
+ let re = "";
661
+ for (let i = 0; i < glob.length; i++) {
662
+ const c = glob[i];
663
+ if (c === "\\") re += `\\${glob[++i] ?? ""}`.replace(/\\([^\w])/, (_, x) => `\\${x}`);
664
+ else if (c === "*") re += ".*";
665
+ else if (c === "?") re += ".";
666
+ else if (c === "[") {
667
+ const end = glob.indexOf("]", i + 1);
668
+ re += `[${glob.slice(i + 1, end).replace(/\\/g, "\\\\")}]`;
669
+ i = end;
670
+ } else re += c.replace(/[.+^${}()|\\/]/g, "\\$&");
671
+ }
672
+ return new RegExp(`^${re}$`, "s");
673
+ }
674
+ /**
675
+ * An in-memory node-redis look-alike: string and RedisJSON values, the driver's two Lua scripts
676
+ * emulated, a SCAN that yields every key twice (Redis may repeat keys), and PSUBSCRIBE with real
677
+ * glob matching (so an unescaped prefix would miss events).
678
+ */
679
+ function fakeRedis(options = {}) {
680
+ return makeFakeRedis(options);
681
+ }
682
+ function makeFakeRedis(options) {
683
+ const strings = /* @__PURE__ */ new Map();
684
+ const zsets = /* @__PURE__ */ new Map();
685
+ const subs = /* @__PURE__ */ new Set();
686
+ const patterns = [];
687
+ const emit = (key, event) => {
688
+ for (const s of subs) {
689
+ const ch = `__keyspace@0__:${key}`;
690
+ if (s.re.test(ch)) queueMicrotask(() => s.listener(event, ch));
691
+ }
692
+ };
693
+ const self = {
694
+ strings,
695
+ patterns,
696
+ zsets,
697
+ async zAdd(key, members) {
698
+ const set = zsets.get(key) ?? /* @__PURE__ */ new Map();
699
+ for (const m of [members].flat()) set.set(m.value, m.score);
700
+ zsets.set(key, set);
701
+ },
702
+ async zRem(key, members) {
703
+ for (const m of [members].flat()) zsets.get(key)?.delete(m);
704
+ },
705
+ async zRangeByScore(key, min, max) {
706
+ const bound = (v) => v === "-inf" ? -Infinity : v === "+inf" ? Infinity : Number(v);
707
+ const lo = bound(min);
708
+ const hi = bound(max);
709
+ return [...zsets.get(key) ?? /* @__PURE__ */ new Map()].filter(([, score]) => score >= lo && score <= hi).sort((a, b) => a[1] - b[1]).map(([member]) => member);
710
+ },
711
+ isOpen: false,
712
+ on: () => self,
713
+ async connect() {
714
+ self.isOpen = true;
715
+ },
716
+ async quit() {
717
+ self.isOpen = false;
718
+ },
719
+ async disconnect() {
720
+ self.isOpen = false;
721
+ },
722
+ async get(key) {
723
+ return strings.get(key) ?? null;
724
+ },
725
+ async set(key, value) {
726
+ strings.set(key, value);
727
+ emit(key, "set");
728
+ },
729
+ async del(key) {
730
+ for (const k of [key].flat()) if (strings.delete(k)) emit(k, "del");
731
+ },
732
+ json: {
733
+ async get(key) {
734
+ const raw = strings.get(key);
735
+ return raw === void 0 ? null : JSON.parse(raw);
736
+ },
737
+ async set(key, _path, value) {
738
+ strings.set(key, JSON.stringify(value));
739
+ emit(key, "json.set");
740
+ }
741
+ },
742
+ async eval(script, opts = {}) {
743
+ const [key] = opts.keys ?? [];
744
+ const args = opts.arguments ?? [];
745
+ const custom = options.eval?.(script, opts.keys ?? [], args, self);
746
+ if (custom !== void 0) return custom;
747
+ const raw = strings.get(key) ?? null;
748
+ if (!script.includes("ARGV[4]")) return raw;
749
+ const [mode, expected, next] = args;
750
+ if (mode === "0" ? raw !== null : raw !== expected) return 0;
751
+ strings.set(key, next);
752
+ emit(key, "set");
753
+ return 1;
754
+ },
755
+ async *scanIterator(opts = {}) {
756
+ const re = globToRegExp(opts.MATCH ?? "*");
757
+ const keys = [...strings.keys()].filter((k) => re.test(k));
758
+ yield keys;
759
+ yield keys.slice(0, 3);
760
+ },
761
+ duplicate() {
762
+ return fakeRedisSubscriber();
763
+ },
764
+ async pSubscribe() {}
765
+ };
766
+ function fakeRedisSubscriber() {
767
+ return {
768
+ ...self,
769
+ isOpen: false,
770
+ async connect() {},
771
+ async pSubscribe(pattern, listener) {
772
+ patterns.push(pattern);
773
+ const entry = {
774
+ re: globToRegExp(pattern),
775
+ listener
776
+ };
777
+ subs.add(entry);
778
+ this.disconnect = async () => {
779
+ subs.delete(entry);
780
+ };
781
+ }
782
+ };
783
+ }
784
+ return self;
785
+ }
786
+ /** Cast a fake to the `client` option type of the redis driver factories. */
787
+ const asRedisClient = (c) => c;
788
+ //#endregion
789
+ exports.asRedisClient = asRedisClient;
790
+ exports.capabilitiesCase = capabilitiesCase;
791
+ exports.compareAndSwapCases = compareAndSwapCases;
792
+ exports.contractCases = contractCases;
793
+ exports.fakeRedis = fakeRedis;
794
+ exports.requireCompareAndSwap = requireCompareAndSwap;
795
+ exports.requireWatchable = requireWatchable;
796
+ exports.runConformanceCases = runConformanceCases;
797
+ exports.runStorageConformance = runStorageConformance;
798
+ exports.settle = settle;
799
+ exports.watchCases = watchCases;
800
+
801
+ //# sourceMappingURL=entry-storage-testing.cjs.map