@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,232 @@
1
+ const require_peer = require("./peer-BIjBFzwQ.cjs");
2
+ const require_util = require("./util-dAnTK9x-.cjs");
3
+ const require_json = require("./json-CM7TwYQ7.cjs");
4
+ const require_cas = require("./cas-CuPSaXBV.cjs");
5
+ //#region src/storage/drizzle.ts
6
+ const SUBPATH = "@xtandard/kit/storage/drizzle";
7
+ /** Drizzle's `entityKind` symbol (`Symbol.for`, so no `drizzle-orm` import is needed). */
8
+ const ENTITY_KIND = Symbol.for("drizzle:entityKind");
9
+ const DIALECT_KINDS = {
10
+ PgDialect: "pg",
11
+ MySqlDialect: "mysql",
12
+ SQLiteDialect: "sqlite"
13
+ };
14
+ /**
15
+ * Detect a Drizzle database's dialect from its `dialect` object's class chain (`PgDialect` /
16
+ * `MySqlDialect` / `SQLite{Sync,Async}Dialect`). Semi-public (ADR 0004).
17
+ */
18
+ function detectDrizzleDialect(db) {
19
+ let proto = db?.dialect;
20
+ while (proto) {
21
+ const kind = proto.constructor?.[ENTITY_KIND];
22
+ if (typeof kind === "string" && kind in DIALECT_KINDS) return DIALECT_KINDS[kind];
23
+ proto = Object.getPrototypeOf(proto);
24
+ }
25
+ throw new Error(`${SUBPATH}: cannot detect the Drizzle dialect of \`db\`; pass \`dialect: "pg" | "mysql" | "sqlite"\`.`);
26
+ }
27
+ /** Rows affected by a MySQL write, across driver result shapes (mysql2, PlanetScale…). Semi-public. */
28
+ function affectedRows(result) {
29
+ const header = Array.isArray(result) ? result[0] : result;
30
+ return Number(header?.affectedRows ?? header?.rowsAffected ?? 0);
31
+ }
32
+ let sqlTag;
33
+ /** The `sql` template tag of `drizzle-orm`, imported once (lazily). Semi-public. */
34
+ function drizzleSql() {
35
+ sqlTag ??= require_peer.importPeer("drizzle-orm", SUBPATH, () => import("drizzle-orm")).then((m) => m.sql).catch((error) => {
36
+ sqlTag = void 0;
37
+ throw error;
38
+ });
39
+ return sqlTag;
40
+ }
41
+ /**
42
+ * The smallest string greater than every string that starts with `prefix`, in code-point (=
43
+ * `utf8mb4_bin` byte) order: the last code point incremented (skipping surrogates), dropping
44
+ * trailing U+10FFFF. `undefined` when there is none (empty prefix, or all U+10FFFF).
45
+ */
46
+ function prefixSuccessor(prefix) {
47
+ const points = [...prefix].map((c) => c.codePointAt(0));
48
+ while (points.length > 0) {
49
+ const last = points.pop();
50
+ if (last < 1114111) {
51
+ points.push(last === 55295 ? 57344 : last + 1);
52
+ return String.fromCodePoint(...points);
53
+ }
54
+ }
55
+ }
56
+ /**
57
+ * Thrown by `setItem` on MySQL when the key column's collation is PAD SPACE (`utf8mb4_bin`) and the
58
+ * key differs from a stored key only by trailing spaces (`"a "` vs `"a"`): the write is refused
59
+ * instead of overwriting the other key. The message carries the migration SQL to a NO PAD
60
+ * collation (`utf8mb4_0900_bin`).
61
+ */
62
+ var KeyCollisionError = class extends Error {
63
+ /** The key that was written. */
64
+ key;
65
+ /** The stored key it collides with (when it could be read back). */
66
+ storedKey;
67
+ constructor(key, storedKey, table) {
68
+ const name = String(table[Symbol.for("drizzle:Name")]);
69
+ const target = (table.key.getSQLType?.() ?? "varchar(512)").replace(/COLLATE\s+\w+/i, "COLLATE utf8mb4_0900_bin");
70
+ const withCollation = /COLLATE/i.test(target) ? target : `${target} CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin`;
71
+ super(`${SUBPATH}: key ${JSON.stringify(key)} collides with the stored key ${JSON.stringify(storedKey)} in MySQL table \`${name}\`: its key column uses a PAD SPACE collation (utf8mb4_bin), which ignores trailing spaces. Nothing was overwritten. Migrate the column to a NO PAD collation: ALTER TABLE \`${name}\` MODIFY \`key\` ${withCollation} NOT NULL; (on MariaDB use utf8mb4_nopad_bin).`);
72
+ this.name = "KeyCollisionError";
73
+ this.key = key;
74
+ this.storedKey = storedKey;
75
+ }
76
+ };
77
+ /** A MySQL "invalid JSON text" error (3141), possibly wrapped by Drizzle in `cause`. */
78
+ function isInvalidJsonCast(error) {
79
+ for (let e = error, depth = 0; e && depth < 4; depth++) {
80
+ const { errno, code } = e;
81
+ if (errno === 3141 || code === "ER_INVALID_JSON_TEXT_IN_PARAM") return true;
82
+ e = e.cause;
83
+ }
84
+ return false;
85
+ }
86
+ /**
87
+ * Create a Drizzle-backed {@link DrizzleKvStorage}. No DDL, no connection ownership.
88
+ *
89
+ * @example
90
+ * ```ts
91
+ * import { drizzle } from "drizzle-orm/node-postgres";
92
+ * import { createDrizzleStorage } from "@xtandard/kit/storage/drizzle";
93
+ * import { pgKvTable } from "@xtandard/kit/drizzle/pg";
94
+ *
95
+ * export const kv = pgKvTable("xtandard_kv"); // add to your schema + migrate
96
+ * const storage = createDrizzleStorage({ db: drizzle(pool), table: kv });
97
+ * ```
98
+ */
99
+ function createDrizzleStorage(options) {
100
+ const db = options.db;
101
+ const { table } = options;
102
+ const dialect = options.dialect ?? detectDrizzleDialect(db);
103
+ /** The value column as JSON text, so it is parsed exactly once. */
104
+ const rawValue = (sql) => dialect === "pg" ? sql`${table.value}::text` : dialect === "mysql" ? sql`cast(${table.value} as char)` : sql`cast(${table.value} as text)`;
105
+ /**
106
+ * Exact key match. On MySQL also byte-exact: `utf8mb4_bin` is a PAD SPACE collation, so `key = 'a '`
107
+ * would match the row `'a'`.
108
+ */
109
+ const keyIs = (sql, key) => dialect === "mysql" ? sql`${table.key} = ${key} and cast(${table.key} as binary) = cast(${key} as binary)` : sql`${table.key} = ${key}`;
110
+ /** The stored spelling of the row a PAD SPACE comparison matches for `key`. */
111
+ async function storedSpelling(sql, key) {
112
+ const rows = await db.select({ key: table.key }).from(table).where(sql`${table.key} = ${key}`);
113
+ return rows[0] === void 0 ? void 0 : String(rows[0].key);
114
+ }
115
+ async function readRaw(key) {
116
+ const sql = await drizzleSql();
117
+ const value = (await db.select({ value: rawValue(sql) }).from(table).where(keyIs(sql, key)))[0]?.value;
118
+ return typeof value === "string" ? value : null;
119
+ }
120
+ return {
121
+ async getItem(key) {
122
+ const raw = await readRaw(key);
123
+ return raw === null ? null : JSON.parse(raw);
124
+ },
125
+ async setItem(key, value) {
126
+ const stored = require_json.canonical(value);
127
+ const insert = db.insert(table).values({
128
+ key,
129
+ value: stored
130
+ });
131
+ if (dialect !== "mysql") {
132
+ await insert.onConflictDoUpdate({
133
+ target: table.key,
134
+ set: { value: stored }
135
+ });
136
+ return;
137
+ }
138
+ const sql = await drizzleSql();
139
+ try {
140
+ await insert.onDuplicateKeyUpdate({ set: { value: sql`if(cast(${table.key} as binary) = cast(values(${table.key}) as binary), values(${table.value}), cast(concat('kit-key-collision:', values(${table.key})) as json))` } });
141
+ } catch (error) {
142
+ if (!isInvalidJsonCast(error)) throw error;
143
+ throw new KeyCollisionError(key, await storedSpelling(sql, key), table);
144
+ }
145
+ },
146
+ async removeItem(key) {
147
+ const sql = await drizzleSql();
148
+ await db.delete(table).where(keyIs(sql, key));
149
+ },
150
+ async getKeys(prefix) {
151
+ const sql = await drizzleSql();
152
+ const upper = dialect === "mysql" ? prefixSuccessor(prefix) : void 0;
153
+ const where = dialect === "sqlite" ? sql`${table.key} glob ${`${require_util.escapeGlob(prefix)}*`}` : dialect === "mysql" ? upper === void 0 ? sql`${table.key} >= ${prefix}` : sql`${table.key} >= ${prefix} and ${table.key} < ${upper}` : sql`${table.key} like ${`${require_util.escapeLike(prefix)}%`} escape '!'`;
154
+ return (await db.select({ key: table.key }).from(table).where(where)).map((row) => String(row.key)).filter((key) => key.startsWith(prefix));
155
+ },
156
+ async compareAndSwap(input) {
157
+ const sql = await drizzleSql();
158
+ const next = require_json.canonical(input.next);
159
+ if (input.expected === null) {
160
+ if (dialect === "mysql") return affectedRows(await db.insert(table).ignore().values({
161
+ key: input.key,
162
+ value: next
163
+ })) === 1;
164
+ return (await db.insert(table).values({
165
+ key: input.key,
166
+ value: next
167
+ }).onConflictDoNothing({ target: table.key }).returning({ key: table.key })).length === 1;
168
+ }
169
+ /** Swap when the stored value equals `expected` (SQL expression). */
170
+ const swapWhere = async (valueMatches) => {
171
+ const update = db.update(table).set({ value: next }).where(sql`${keyIs(sql, input.key)} and ${valueMatches}`);
172
+ if (dialect !== "mysql") return (await update.returning({ key: table.key })).length === 1;
173
+ if (affectedRows(await update) === 1) return true;
174
+ if (require_json.canonicalJson(input.next) !== require_json.canonicalJson(input.expected)) return false;
175
+ const raw = await readRaw(input.key);
176
+ return raw !== null && require_json.deepEqual(JSON.parse(raw), input.expected);
177
+ };
178
+ if (dialect === "pg") return swapWhere(sql`${table.value} = ${require_json.canonicalJson(input.expected)}::jsonb`);
179
+ if (dialect === "mysql") return swapWhere(sql`${table.value} = cast(${require_json.canonicalJson(input.expected)} as json)`);
180
+ return require_cas.swapWithFallback(input.expected, {
181
+ fast: () => swapWhere(sql`${table.value} = ${require_json.canonicalJson(input.expected)}`),
182
+ async read() {
183
+ const raw = await readRaw(input.key);
184
+ return raw === null ? null : {
185
+ raw,
186
+ value: JSON.parse(raw)
187
+ };
188
+ },
189
+ swapRaw: (raw) => swapWhere(sql`${table.value} = ${raw}`)
190
+ });
191
+ }
192
+ };
193
+ }
194
+ //#endregion
195
+ Object.defineProperty(exports, "KeyCollisionError", {
196
+ enumerable: true,
197
+ get: function() {
198
+ return KeyCollisionError;
199
+ }
200
+ });
201
+ Object.defineProperty(exports, "affectedRows", {
202
+ enumerable: true,
203
+ get: function() {
204
+ return affectedRows;
205
+ }
206
+ });
207
+ Object.defineProperty(exports, "createDrizzleStorage", {
208
+ enumerable: true,
209
+ get: function() {
210
+ return createDrizzleStorage;
211
+ }
212
+ });
213
+ Object.defineProperty(exports, "detectDrizzleDialect", {
214
+ enumerable: true,
215
+ get: function() {
216
+ return detectDrizzleDialect;
217
+ }
218
+ });
219
+ Object.defineProperty(exports, "drizzleSql", {
220
+ enumerable: true,
221
+ get: function() {
222
+ return drizzleSql;
223
+ }
224
+ });
225
+ Object.defineProperty(exports, "prefixSuccessor", {
226
+ enumerable: true,
227
+ get: function() {
228
+ return prefixSuccessor;
229
+ }
230
+ });
231
+
232
+ //# sourceMappingURL=drizzle-BXaQXCr0.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drizzle-BXaQXCr0.cjs","names":["importPeer","canonical","escapeGlob","escapeLike","canonicalJson","deepEqual","swapWithFallback"],"sources":["../src/storage/drizzle.ts"],"sourcesContent":["/**\n * Drizzle storage driver: a {@link KvStorage} over a **consumer-owned** Drizzle table and database.\n * It issues no DDL (the table lives in your schema and migrations; build it with\n * `@xtandard/kit/drizzle/{pg,mysql,sqlite}`) and owns no connection (it never closes `db`).\n *\n * Postgres, MySQL and SQLite: the dialect is read from `db`, or set with `dialect`.\n *\n * - `getKeys` matches prefixes literally: `LIKE … ESCAPE '!'` on Postgres, `GLOB` on SQLite (whose\n * `LIKE` folds ASCII case), and a bytewise range `key >= p AND key < successor(p)` on MySQL (whose\n * range optimizer skips emoji for an indexed `LIKE 'p%'` on a `utf8mb4_bin` key), plus an exact\n * `startsWith` filter everywhere.\n * - Values are written canonically and read as raw JSON text, parsed once (so a stored string that\n * looks like JSON stays a string).\n * - `compareAndSwap` is one conditional `UPDATE` (or a conflict-ignoring `INSERT` for an absent\n * key): `jsonb` equality on Postgres and `JSON` equality on MySQL (both structural), canonical\n * text on SQLite with a structural fallback for rows written before canonicalisation.\n *\n * - MySQL `utf8mb4_bin` keys are PAD SPACE (`\"a \"` = `\"a\"`): reads, removes and swaps match keys\n * byte-exactly, and a write whose key differs from a stored one only by trailing spaces throws\n * {@link KeyCollisionError} instead of overwriting it. `mysqlKvTable(name, { keyCollation:\n * \"utf8mb4_0900_bin\" })` (NO PAD) avoids the collision.\n *\n * `drizzle-orm` is loaded lazily on first use, so importing this subpath never loads the peer.\n *\n * @module\n */\n\nimport type { Column, SQL, Table } from \"drizzle-orm\";\nimport type { DrizzleKvTable } from \"../drizzle/table.ts\";\nimport { canonical, canonicalJson, deepEqual } from \"../internal/json.ts\";\nimport { importPeer } from \"../internal/peer.ts\";\nimport { swapWithFallback } from \"./cas.ts\";\nimport type { CompareAndSwapInput, CompareAndSwapKvStorage } from \"./contract.ts\";\nimport { escapeGlob, escapeLike } from \"./util.ts\";\n\nexport type { DrizzleKvTable } from \"../drizzle/table.ts\";\n\nconst SUBPATH = \"@xtandard/kit/storage/drizzle\";\n\n/** The SQL dialect of a Drizzle database. */\nexport type DrizzleDialect = \"pg\" | \"mysql\" | \"sqlite\";\n\n/**\n * Minimal structural view of a Drizzle database (the query-builder entry points the driver uses).\n * The public `db` option is `unknown` because a dialect-agnostic type cannot match every dialect's\n * builders.\n */\nexport interface DrizzleLikeDatabase {\n /** The dialect object (its class chain names the dialect). */\n dialect?: unknown;\n /** `select(fields).from(table).where(sql)`. */\n select(fields: Record<string, unknown>): {\n from(table: Table): { where(where: SQL): PromiseLike<unknown[]> };\n };\n /** `insert(table)`. */\n insert(table: Table): DrizzleInsert;\n /** `update(table).set(values).where(sql)`. */\n update(table: Table): {\n set(values: Record<string, unknown>): {\n where(where: SQL): PromiseLike<unknown> & {\n returning?(fields: Record<string, Column>): PromiseLike<unknown[]>;\n };\n };\n };\n /** `delete(table).where(sql)`. */\n delete(table: Table): { where(where: SQL): PromiseLike<unknown> };\n}\n\n/** The insert builder surface (upsert methods differ by dialect). */\ninterface DrizzleInsert {\n ignore?(): DrizzleInsert;\n values(row: Record<string, unknown>): PromiseLike<unknown> & {\n onConflictDoUpdate?(config: { target: Column; set: Record<string, unknown> }): DrizzleReturning;\n onConflictDoNothing?(config?: { target?: Column }): DrizzleReturning;\n onDuplicateKeyUpdate?(config: { set: Record<string, unknown> }): PromiseLike<unknown>;\n };\n}\n\ntype DrizzleReturning = PromiseLike<unknown> & {\n returning(fields: Record<string, Column>): PromiseLike<unknown[]>;\n};\n\n/** Drizzle's `entityKind` symbol (`Symbol.for`, so no `drizzle-orm` import is needed). */\nconst ENTITY_KIND = Symbol.for(\"drizzle:entityKind\");\n\nconst DIALECT_KINDS: Record<string, DrizzleDialect> = {\n PgDialect: \"pg\",\n MySqlDialect: \"mysql\",\n SQLiteDialect: \"sqlite\",\n};\n\n/**\n * Detect a Drizzle database's dialect from its `dialect` object's class chain (`PgDialect` /\n * `MySqlDialect` / `SQLite{Sync,Async}Dialect`). Semi-public (ADR 0004).\n */\nexport function detectDrizzleDialect(db: unknown): DrizzleDialect {\n let proto: unknown = (db as DrizzleLikeDatabase | null)?.dialect;\n while (proto) {\n const kind = (proto as { constructor?: Record<symbol, unknown> }).constructor?.[ENTITY_KIND];\n if (typeof kind === \"string\" && kind in DIALECT_KINDS) return DIALECT_KINDS[kind]!;\n proto = Object.getPrototypeOf(proto);\n }\n throw new Error(\n `${SUBPATH}: cannot detect the Drizzle dialect of \\`db\\`; pass \\`dialect: \"pg\" | \"mysql\" | \"sqlite\"\\`.`,\n );\n}\n\n/** Rows affected by a MySQL write, across driver result shapes (mysql2, PlanetScale…). Semi-public. */\nexport function affectedRows(result: unknown): number {\n const header = (Array.isArray(result) ? result[0] : result) as\n | { affectedRows?: number; rowsAffected?: number }\n | undefined;\n return Number(header?.affectedRows ?? header?.rowsAffected ?? 0);\n}\n\ntype SqlTag = typeof import(\"drizzle-orm\").sql;\nlet sqlTag: Promise<SqlTag> | undefined;\n\n/** The `sql` template tag of `drizzle-orm`, imported once (lazily). Semi-public. */\nexport function drizzleSql(): Promise<SqlTag> {\n sqlTag ??= importPeer(\"drizzle-orm\", SUBPATH, () => import(\"drizzle-orm\"))\n .then((m) => m.sql)\n .catch((error: unknown) => {\n sqlTag = undefined;\n throw error;\n });\n return sqlTag;\n}\n\n/**\n * The smallest string greater than every string that starts with `prefix`, in code-point (=\n * `utf8mb4_bin` byte) order: the last code point incremented (skipping surrogates), dropping\n * trailing U+10FFFF. `undefined` when there is none (empty prefix, or all U+10FFFF).\n */\nexport function prefixSuccessor(prefix: string): string | undefined {\n const points = [...prefix].map((c) => c.codePointAt(0)!);\n while (points.length > 0) {\n const last = points.pop()!;\n if (last < 0x10ffff) {\n points.push(last === 0xd7ff ? 0xe000 : last + 1);\n return String.fromCodePoint(...points);\n }\n }\n return undefined;\n}\n\n/**\n * Thrown by `setItem` on MySQL when the key column's collation is PAD SPACE (`utf8mb4_bin`) and the\n * key differs from a stored key only by trailing spaces (`\"a \"` vs `\"a\"`): the write is refused\n * instead of overwriting the other key. The message carries the migration SQL to a NO PAD\n * collation (`utf8mb4_0900_bin`).\n */\nexport class KeyCollisionError extends Error {\n /** The key that was written. */\n readonly key: string;\n /** The stored key it collides with (when it could be read back). */\n readonly storedKey: string | undefined;\n\n constructor(key: string, storedKey: string | undefined, table: DrizzleKvTable) {\n const name = String((table as unknown as Record<symbol, unknown>)[Symbol.for(\"drizzle:Name\")]);\n const type = (table.key as { getSQLType?: () => string }).getSQLType?.() ?? \"varchar(512)\";\n const target = type.replace(/COLLATE\\s+\\w+/i, \"COLLATE utf8mb4_0900_bin\");\n const withCollation = /COLLATE/i.test(target)\n ? target\n : `${target} CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin`;\n super(\n `${SUBPATH}: key ${JSON.stringify(key)} collides with the stored key ${JSON.stringify(storedKey)} ` +\n `in MySQL table \\`${name}\\`: its key column uses a PAD SPACE collation (utf8mb4_bin), which ` +\n \"ignores trailing spaces. Nothing was overwritten. Migrate the column to a NO PAD collation: \" +\n `ALTER TABLE \\`${name}\\` MODIFY \\`key\\` ${withCollation} NOT NULL; ` +\n \"(on MariaDB use utf8mb4_nopad_bin).\",\n );\n this.name = \"KeyCollisionError\";\n this.key = key;\n this.storedKey = storedKey;\n }\n}\n\n/** A MySQL \"invalid JSON text\" error (3141), possibly wrapped by Drizzle in `cause`. */\nfunction isInvalidJsonCast(error: unknown): boolean {\n for (let e: unknown = error, depth = 0; e && depth < 4; depth++) {\n const { errno, code } = e as { errno?: unknown; code?: unknown };\n if (errno === 3141 || code === \"ER_INVALID_JSON_TEXT_IN_PARAM\") return true;\n e = (e as { cause?: unknown }).cause;\n }\n return false;\n}\n\n/** Options for {@link createDrizzleStorage}. */\nexport interface DrizzleStorageOptions {\n /** Your Drizzle database (node-postgres, postgres-js, mysql2, bun:sqlite, libsql, pglite, …). */\n db: unknown;\n /** The KV table, built with a `@xtandard/kit/drizzle/*` factory (or matching its shape). */\n table: DrizzleKvTable;\n /** Override dialect detection (normally read from `db`). */\n dialect?: DrizzleDialect;\n}\n\n/**\n * A compare-and-swap capable storage over a Drizzle table. For change notifications, compose it with\n * `withWatch` and a change source such as `pgListenNotify`.\n */\nexport type DrizzleKvStorage = CompareAndSwapKvStorage;\n\n/**\n * Create a Drizzle-backed {@link DrizzleKvStorage}. No DDL, no connection ownership.\n *\n * @example\n * ```ts\n * import { drizzle } from \"drizzle-orm/node-postgres\";\n * import { createDrizzleStorage } from \"@xtandard/kit/storage/drizzle\";\n * import { pgKvTable } from \"@xtandard/kit/drizzle/pg\";\n *\n * export const kv = pgKvTable(\"xtandard_kv\"); // add to your schema + migrate\n * const storage = createDrizzleStorage({ db: drizzle(pool), table: kv });\n * ```\n */\nexport function createDrizzleStorage(options: DrizzleStorageOptions): DrizzleKvStorage {\n const db = options.db as DrizzleLikeDatabase;\n const { table } = options;\n const dialect = options.dialect ?? detectDrizzleDialect(db);\n\n /** The value column as JSON text, so it is parsed exactly once. */\n const rawValue = (sql: SqlTag): SQL =>\n dialect === \"pg\"\n ? sql`${table.value}::text`\n : dialect === \"mysql\"\n ? sql`cast(${table.value} as char)`\n : sql`cast(${table.value} as text)`;\n\n /**\n * Exact key match. On MySQL also byte-exact: `utf8mb4_bin` is a PAD SPACE collation, so `key = 'a '`\n * would match the row `'a'`.\n */\n const keyIs = (sql: SqlTag, key: string): SQL =>\n dialect === \"mysql\"\n ? sql`${table.key} = ${key} and cast(${table.key} as binary) = cast(${key} as binary)`\n : sql`${table.key} = ${key}`;\n\n /** The stored spelling of the row a PAD SPACE comparison matches for `key`. */\n async function storedSpelling(sql: SqlTag, key: string): Promise<string | undefined> {\n const rows = (await db\n .select({ key: table.key })\n .from(table)\n .where(sql`${table.key} = ${key}`)) as Array<{ key: unknown }>;\n return rows[0] === undefined ? undefined : String(rows[0].key);\n }\n\n async function readRaw(key: string): Promise<string | null> {\n const sql = await drizzleSql();\n const rows = (await db\n .select({ value: rawValue(sql) })\n .from(table)\n .where(keyIs(sql, key))) as Array<{ value: unknown }>;\n const value = rows[0]?.value;\n return typeof value === \"string\" ? value : null;\n }\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const raw = await readRaw(key);\n return raw === null ? null : (JSON.parse(raw) as T);\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n const stored = canonical(value);\n const insert = db.insert(table).values({ key, value: stored });\n if (dialect !== \"mysql\") {\n await insert.onConflictDoUpdate!({ target: table.key, set: { value: stored } });\n return;\n }\n // On a PAD SPACE key column `'a '` hits the row `'a'`: update only a byte-exact match and make\n // a mismatch fail the statement (an invalid JSON cast) instead of overwriting another key.\n // `VALUES()` is deprecated since MySQL 8.0.20 but kept: MariaDB has no row alias (`AS new`).\n const sql = await drizzleSql();\n try {\n await insert.onDuplicateKeyUpdate!({\n set: {\n value: sql`if(cast(${table.key} as binary) = cast(values(${table.key}) as binary), values(${table.value}), cast(concat('kit-key-collision:', values(${table.key})) as json))`,\n },\n });\n } catch (error) {\n if (!isInvalidJsonCast(error)) throw error;\n throw new KeyCollisionError(key, await storedSpelling(sql, key), table);\n }\n },\n\n async removeItem(key: string): Promise<void> {\n const sql = await drizzleSql();\n await db.delete(table).where(keyIs(sql, key));\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n const sql = await drizzleSql();\n const upper = dialect === \"mysql\" ? prefixSuccessor(prefix) : undefined;\n const where =\n dialect === \"sqlite\"\n ? sql`${table.key} glob ${`${escapeGlob(prefix)}*`}`\n : dialect === \"mysql\"\n ? // MySQL's range optimizer skips supplementary characters (emoji) for an indexed\n // `LIKE 'p%'` on a utf8mb4_bin key: match the bytewise range instead.\n upper === undefined\n ? sql`${table.key} >= ${prefix}`\n : sql`${table.key} >= ${prefix} and ${table.key} < ${upper}`\n : sql`${table.key} like ${`${escapeLike(prefix)}%`} escape '!'`;\n const rows = (await db.select({ key: table.key }).from(table).where(where)) as Array<{\n key: unknown;\n }>;\n // A hand-made table with a case/accent-folding collation could over-match.\n return rows.map((row) => String(row.key)).filter((key) => key.startsWith(prefix));\n },\n\n async compareAndSwap<T>(input: CompareAndSwapInput<T>): Promise<boolean> {\n const sql = await drizzleSql();\n const next = canonical(input.next);\n if (input.expected === null) {\n if (dialect === \"mysql\") {\n const result = await db.insert(table).ignore!().values({ key: input.key, value: next });\n return affectedRows(result) === 1;\n }\n const rows = await db.insert(table).values({ key: input.key, value: next })\n .onConflictDoNothing!({ target: table.key }).returning({ key: table.key });\n return rows.length === 1;\n }\n\n /** Swap when the stored value equals `expected` (SQL expression). */\n const swapWhere = async (valueMatches: SQL): Promise<boolean> => {\n const update = db\n .update(table)\n .set({ value: next })\n .where(sql`${keyIs(sql, input.key)} and ${valueMatches}`);\n if (dialect !== \"mysql\") return (await update.returning!({ key: table.key })).length === 1;\n if (affectedRows(await update) === 1) return true;\n // Without CLIENT_FOUND_ROWS, MySQL counts *changed* rows: a swap to an equal value reports 0.\n if (canonicalJson(input.next) !== canonicalJson(input.expected)) return false;\n const raw = await readRaw(input.key);\n return raw !== null && deepEqual(JSON.parse(raw), input.expected);\n };\n\n if (dialect === \"pg\") {\n return swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}::jsonb`);\n }\n if (dialect === \"mysql\") {\n return swapWhere(sql`${table.value} = cast(${canonicalJson(input.expected)} as json)`);\n }\n // SQLite stores text: canonical fast path, then the structural fallback on legacy rows.\n return swapWithFallback<string>(input.expected, {\n fast: () => swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}`),\n async read() {\n const raw = await readRaw(input.key);\n return raw === null ? null : { raw, value: JSON.parse(raw) as unknown };\n },\n swapRaw: (raw) => swapWhere(sql`${table.value} = ${raw}`),\n });\n },\n };\n}\n"],"mappings":"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"}
@@ -0,0 +1,115 @@
1
+ import { t as DrizzleKvTable } from "./table-BrioFSra.cjs";
2
+ import { n as CompareAndSwapKvStorage } from "./contract-BvgtswLX.cjs";
3
+ import { Column, SQL, Table } from "drizzle-orm";
4
+
5
+ //#region src/storage/drizzle.d.ts
6
+ /** The SQL dialect of a Drizzle database. */
7
+ type DrizzleDialect = "pg" | "mysql" | "sqlite";
8
+ /**
9
+ * Minimal structural view of a Drizzle database (the query-builder entry points the driver uses).
10
+ * The public `db` option is `unknown` because a dialect-agnostic type cannot match every dialect's
11
+ * builders.
12
+ */
13
+ interface DrizzleLikeDatabase {
14
+ /** The dialect object (its class chain names the dialect). */
15
+ dialect?: unknown;
16
+ /** `select(fields).from(table).where(sql)`. */
17
+ select(fields: Record<string, unknown>): {
18
+ from(table: Table): {
19
+ where(where: SQL): PromiseLike<unknown[]>;
20
+ };
21
+ };
22
+ /** `insert(table)`. */
23
+ insert(table: Table): DrizzleInsert;
24
+ /** `update(table).set(values).where(sql)`. */
25
+ update(table: Table): {
26
+ set(values: Record<string, unknown>): {
27
+ where(where: SQL): PromiseLike<unknown> & {
28
+ returning?(fields: Record<string, Column>): PromiseLike<unknown[]>;
29
+ };
30
+ };
31
+ };
32
+ /** `delete(table).where(sql)`. */
33
+ delete(table: Table): {
34
+ where(where: SQL): PromiseLike<unknown>;
35
+ };
36
+ }
37
+ /** The insert builder surface (upsert methods differ by dialect). */
38
+ interface DrizzleInsert {
39
+ ignore?(): DrizzleInsert;
40
+ values(row: Record<string, unknown>): PromiseLike<unknown> & {
41
+ onConflictDoUpdate?(config: {
42
+ target: Column;
43
+ set: Record<string, unknown>;
44
+ }): DrizzleReturning;
45
+ onConflictDoNothing?(config?: {
46
+ target?: Column;
47
+ }): DrizzleReturning;
48
+ onDuplicateKeyUpdate?(config: {
49
+ set: Record<string, unknown>;
50
+ }): PromiseLike<unknown>;
51
+ };
52
+ }
53
+ type DrizzleReturning = PromiseLike<unknown> & {
54
+ returning(fields: Record<string, Column>): PromiseLike<unknown[]>;
55
+ };
56
+ /**
57
+ * Detect a Drizzle database's dialect from its `dialect` object's class chain (`PgDialect` /
58
+ * `MySqlDialect` / `SQLite{Sync,Async}Dialect`). Semi-public (ADR 0004).
59
+ */
60
+ declare function detectDrizzleDialect(db: unknown): DrizzleDialect;
61
+ /** Rows affected by a MySQL write, across driver result shapes (mysql2, PlanetScale…). Semi-public. */
62
+ declare function affectedRows(result: unknown): number;
63
+ type SqlTag = typeof import("drizzle-orm").sql;
64
+ /** The `sql` template tag of `drizzle-orm`, imported once (lazily). Semi-public. */
65
+ declare function drizzleSql(): Promise<SqlTag>;
66
+ /**
67
+ * The smallest string greater than every string that starts with `prefix`, in code-point (=
68
+ * `utf8mb4_bin` byte) order: the last code point incremented (skipping surrogates), dropping
69
+ * trailing U+10FFFF. `undefined` when there is none (empty prefix, or all U+10FFFF).
70
+ */
71
+ declare function prefixSuccessor(prefix: string): string | undefined;
72
+ /**
73
+ * Thrown by `setItem` on MySQL when the key column's collation is PAD SPACE (`utf8mb4_bin`) and the
74
+ * key differs from a stored key only by trailing spaces (`"a "` vs `"a"`): the write is refused
75
+ * instead of overwriting the other key. The message carries the migration SQL to a NO PAD
76
+ * collation (`utf8mb4_0900_bin`).
77
+ */
78
+ declare class KeyCollisionError extends Error {
79
+ /** The key that was written. */
80
+ readonly key: string;
81
+ /** The stored key it collides with (when it could be read back). */
82
+ readonly storedKey: string | undefined;
83
+ constructor(key: string, storedKey: string | undefined, table: DrizzleKvTable);
84
+ }
85
+ /** Options for {@link createDrizzleStorage}. */
86
+ interface DrizzleStorageOptions {
87
+ /** Your Drizzle database (node-postgres, postgres-js, mysql2, bun:sqlite, libsql, pglite, …). */
88
+ db: unknown;
89
+ /** The KV table, built with a `@xtandard/kit/drizzle/*` factory (or matching its shape). */
90
+ table: DrizzleKvTable;
91
+ /** Override dialect detection (normally read from `db`). */
92
+ dialect?: DrizzleDialect;
93
+ }
94
+ /**
95
+ * A compare-and-swap capable storage over a Drizzle table. For change notifications, compose it with
96
+ * `withWatch` and a change source such as `pgListenNotify`.
97
+ */
98
+ type DrizzleKvStorage = CompareAndSwapKvStorage;
99
+ /**
100
+ * Create a Drizzle-backed {@link DrizzleKvStorage}. No DDL, no connection ownership.
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * import { drizzle } from "drizzle-orm/node-postgres";
105
+ * import { createDrizzleStorage } from "@xtandard/kit/storage/drizzle";
106
+ * import { pgKvTable } from "@xtandard/kit/drizzle/pg";
107
+ *
108
+ * export const kv = pgKvTable("xtandard_kv"); // add to your schema + migrate
109
+ * const storage = createDrizzleStorage({ db: drizzle(pool), table: kv });
110
+ * ```
111
+ */
112
+ declare function createDrizzleStorage(options: DrizzleStorageOptions): DrizzleKvStorage;
113
+ //#endregion
114
+ export { KeyCollisionError as a, detectDrizzleDialect as c, DrizzleStorageOptions as i, drizzleSql as l, DrizzleKvStorage as n, affectedRows as o, DrizzleLikeDatabase as r, createDrizzleStorage as s, DrizzleDialect as t, prefixSuccessor as u };
115
+ //# sourceMappingURL=drizzle-CEpahWQB.d.cts.map
@@ -0,0 +1,197 @@
1
+ import { t as importPeer } from "./peer-CTHMzOdn.mjs";
2
+ import { i as escapeLike, r as escapeGlob } from "./util-Dnj5T-yw.mjs";
3
+ import { i as deepEqual, n as canonicalJson, t as canonical } from "./json-CmM1M5Kz.mjs";
4
+ import { t as swapWithFallback } from "./cas-CzA-yECx.mjs";
5
+ //#region src/storage/drizzle.ts
6
+ const SUBPATH = "@xtandard/kit/storage/drizzle";
7
+ /** Drizzle's `entityKind` symbol (`Symbol.for`, so no `drizzle-orm` import is needed). */
8
+ const ENTITY_KIND = Symbol.for("drizzle:entityKind");
9
+ const DIALECT_KINDS = {
10
+ PgDialect: "pg",
11
+ MySqlDialect: "mysql",
12
+ SQLiteDialect: "sqlite"
13
+ };
14
+ /**
15
+ * Detect a Drizzle database's dialect from its `dialect` object's class chain (`PgDialect` /
16
+ * `MySqlDialect` / `SQLite{Sync,Async}Dialect`). Semi-public (ADR 0004).
17
+ */
18
+ function detectDrizzleDialect(db) {
19
+ let proto = db?.dialect;
20
+ while (proto) {
21
+ const kind = proto.constructor?.[ENTITY_KIND];
22
+ if (typeof kind === "string" && kind in DIALECT_KINDS) return DIALECT_KINDS[kind];
23
+ proto = Object.getPrototypeOf(proto);
24
+ }
25
+ throw new Error(`${SUBPATH}: cannot detect the Drizzle dialect of \`db\`; pass \`dialect: "pg" | "mysql" | "sqlite"\`.`);
26
+ }
27
+ /** Rows affected by a MySQL write, across driver result shapes (mysql2, PlanetScale…). Semi-public. */
28
+ function affectedRows(result) {
29
+ const header = Array.isArray(result) ? result[0] : result;
30
+ return Number(header?.affectedRows ?? header?.rowsAffected ?? 0);
31
+ }
32
+ let sqlTag;
33
+ /** The `sql` template tag of `drizzle-orm`, imported once (lazily). Semi-public. */
34
+ function drizzleSql() {
35
+ sqlTag ??= importPeer("drizzle-orm", SUBPATH, () => import("drizzle-orm")).then((m) => m.sql).catch((error) => {
36
+ sqlTag = void 0;
37
+ throw error;
38
+ });
39
+ return sqlTag;
40
+ }
41
+ /**
42
+ * The smallest string greater than every string that starts with `prefix`, in code-point (=
43
+ * `utf8mb4_bin` byte) order: the last code point incremented (skipping surrogates), dropping
44
+ * trailing U+10FFFF. `undefined` when there is none (empty prefix, or all U+10FFFF).
45
+ */
46
+ function prefixSuccessor(prefix) {
47
+ const points = [...prefix].map((c) => c.codePointAt(0));
48
+ while (points.length > 0) {
49
+ const last = points.pop();
50
+ if (last < 1114111) {
51
+ points.push(last === 55295 ? 57344 : last + 1);
52
+ return String.fromCodePoint(...points);
53
+ }
54
+ }
55
+ }
56
+ /**
57
+ * Thrown by `setItem` on MySQL when the key column's collation is PAD SPACE (`utf8mb4_bin`) and the
58
+ * key differs from a stored key only by trailing spaces (`"a "` vs `"a"`): the write is refused
59
+ * instead of overwriting the other key. The message carries the migration SQL to a NO PAD
60
+ * collation (`utf8mb4_0900_bin`).
61
+ */
62
+ var KeyCollisionError = class extends Error {
63
+ /** The key that was written. */
64
+ key;
65
+ /** The stored key it collides with (when it could be read back). */
66
+ storedKey;
67
+ constructor(key, storedKey, table) {
68
+ const name = String(table[Symbol.for("drizzle:Name")]);
69
+ const target = (table.key.getSQLType?.() ?? "varchar(512)").replace(/COLLATE\s+\w+/i, "COLLATE utf8mb4_0900_bin");
70
+ const withCollation = /COLLATE/i.test(target) ? target : `${target} CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin`;
71
+ super(`${SUBPATH}: key ${JSON.stringify(key)} collides with the stored key ${JSON.stringify(storedKey)} in MySQL table \`${name}\`: its key column uses a PAD SPACE collation (utf8mb4_bin), which ignores trailing spaces. Nothing was overwritten. Migrate the column to a NO PAD collation: ALTER TABLE \`${name}\` MODIFY \`key\` ${withCollation} NOT NULL; (on MariaDB use utf8mb4_nopad_bin).`);
72
+ this.name = "KeyCollisionError";
73
+ this.key = key;
74
+ this.storedKey = storedKey;
75
+ }
76
+ };
77
+ /** A MySQL "invalid JSON text" error (3141), possibly wrapped by Drizzle in `cause`. */
78
+ function isInvalidJsonCast(error) {
79
+ for (let e = error, depth = 0; e && depth < 4; depth++) {
80
+ const { errno, code } = e;
81
+ if (errno === 3141 || code === "ER_INVALID_JSON_TEXT_IN_PARAM") return true;
82
+ e = e.cause;
83
+ }
84
+ return false;
85
+ }
86
+ /**
87
+ * Create a Drizzle-backed {@link DrizzleKvStorage}. No DDL, no connection ownership.
88
+ *
89
+ * @example
90
+ * ```ts
91
+ * import { drizzle } from "drizzle-orm/node-postgres";
92
+ * import { createDrizzleStorage } from "@xtandard/kit/storage/drizzle";
93
+ * import { pgKvTable } from "@xtandard/kit/drizzle/pg";
94
+ *
95
+ * export const kv = pgKvTable("xtandard_kv"); // add to your schema + migrate
96
+ * const storage = createDrizzleStorage({ db: drizzle(pool), table: kv });
97
+ * ```
98
+ */
99
+ function createDrizzleStorage(options) {
100
+ const db = options.db;
101
+ const { table } = options;
102
+ const dialect = options.dialect ?? detectDrizzleDialect(db);
103
+ /** The value column as JSON text, so it is parsed exactly once. */
104
+ const rawValue = (sql) => dialect === "pg" ? sql`${table.value}::text` : dialect === "mysql" ? sql`cast(${table.value} as char)` : sql`cast(${table.value} as text)`;
105
+ /**
106
+ * Exact key match. On MySQL also byte-exact: `utf8mb4_bin` is a PAD SPACE collation, so `key = 'a '`
107
+ * would match the row `'a'`.
108
+ */
109
+ const keyIs = (sql, key) => dialect === "mysql" ? sql`${table.key} = ${key} and cast(${table.key} as binary) = cast(${key} as binary)` : sql`${table.key} = ${key}`;
110
+ /** The stored spelling of the row a PAD SPACE comparison matches for `key`. */
111
+ async function storedSpelling(sql, key) {
112
+ const rows = await db.select({ key: table.key }).from(table).where(sql`${table.key} = ${key}`);
113
+ return rows[0] === void 0 ? void 0 : String(rows[0].key);
114
+ }
115
+ async function readRaw(key) {
116
+ const sql = await drizzleSql();
117
+ const value = (await db.select({ value: rawValue(sql) }).from(table).where(keyIs(sql, key)))[0]?.value;
118
+ return typeof value === "string" ? value : null;
119
+ }
120
+ return {
121
+ async getItem(key) {
122
+ const raw = await readRaw(key);
123
+ return raw === null ? null : JSON.parse(raw);
124
+ },
125
+ async setItem(key, value) {
126
+ const stored = canonical(value);
127
+ const insert = db.insert(table).values({
128
+ key,
129
+ value: stored
130
+ });
131
+ if (dialect !== "mysql") {
132
+ await insert.onConflictDoUpdate({
133
+ target: table.key,
134
+ set: { value: stored }
135
+ });
136
+ return;
137
+ }
138
+ const sql = await drizzleSql();
139
+ try {
140
+ await insert.onDuplicateKeyUpdate({ set: { value: sql`if(cast(${table.key} as binary) = cast(values(${table.key}) as binary), values(${table.value}), cast(concat('kit-key-collision:', values(${table.key})) as json))` } });
141
+ } catch (error) {
142
+ if (!isInvalidJsonCast(error)) throw error;
143
+ throw new KeyCollisionError(key, await storedSpelling(sql, key), table);
144
+ }
145
+ },
146
+ async removeItem(key) {
147
+ const sql = await drizzleSql();
148
+ await db.delete(table).where(keyIs(sql, key));
149
+ },
150
+ async getKeys(prefix) {
151
+ const sql = await drizzleSql();
152
+ const upper = dialect === "mysql" ? prefixSuccessor(prefix) : void 0;
153
+ const where = dialect === "sqlite" ? sql`${table.key} glob ${`${escapeGlob(prefix)}*`}` : dialect === "mysql" ? upper === void 0 ? sql`${table.key} >= ${prefix}` : sql`${table.key} >= ${prefix} and ${table.key} < ${upper}` : sql`${table.key} like ${`${escapeLike(prefix)}%`} escape '!'`;
154
+ return (await db.select({ key: table.key }).from(table).where(where)).map((row) => String(row.key)).filter((key) => key.startsWith(prefix));
155
+ },
156
+ async compareAndSwap(input) {
157
+ const sql = await drizzleSql();
158
+ const next = canonical(input.next);
159
+ if (input.expected === null) {
160
+ if (dialect === "mysql") return affectedRows(await db.insert(table).ignore().values({
161
+ key: input.key,
162
+ value: next
163
+ })) === 1;
164
+ return (await db.insert(table).values({
165
+ key: input.key,
166
+ value: next
167
+ }).onConflictDoNothing({ target: table.key }).returning({ key: table.key })).length === 1;
168
+ }
169
+ /** Swap when the stored value equals `expected` (SQL expression). */
170
+ const swapWhere = async (valueMatches) => {
171
+ const update = db.update(table).set({ value: next }).where(sql`${keyIs(sql, input.key)} and ${valueMatches}`);
172
+ if (dialect !== "mysql") return (await update.returning({ key: table.key })).length === 1;
173
+ if (affectedRows(await update) === 1) return true;
174
+ if (canonicalJson(input.next) !== canonicalJson(input.expected)) return false;
175
+ const raw = await readRaw(input.key);
176
+ return raw !== null && deepEqual(JSON.parse(raw), input.expected);
177
+ };
178
+ if (dialect === "pg") return swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}::jsonb`);
179
+ if (dialect === "mysql") return swapWhere(sql`${table.value} = cast(${canonicalJson(input.expected)} as json)`);
180
+ return swapWithFallback(input.expected, {
181
+ fast: () => swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}`),
182
+ async read() {
183
+ const raw = await readRaw(input.key);
184
+ return raw === null ? null : {
185
+ raw,
186
+ value: JSON.parse(raw)
187
+ };
188
+ },
189
+ swapRaw: (raw) => swapWhere(sql`${table.value} = ${raw}`)
190
+ });
191
+ }
192
+ };
193
+ }
194
+ //#endregion
195
+ export { drizzleSql as a, detectDrizzleDialect as i, affectedRows as n, prefixSuccessor as o, createDrizzleStorage as r, KeyCollisionError as t };
196
+
197
+ //# sourceMappingURL=drizzle-DxnelsPT.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drizzle-DxnelsPT.mjs","names":[],"sources":["../src/storage/drizzle.ts"],"sourcesContent":["/**\n * Drizzle storage driver: a {@link KvStorage} over a **consumer-owned** Drizzle table and database.\n * It issues no DDL (the table lives in your schema and migrations; build it with\n * `@xtandard/kit/drizzle/{pg,mysql,sqlite}`) and owns no connection (it never closes `db`).\n *\n * Postgres, MySQL and SQLite: the dialect is read from `db`, or set with `dialect`.\n *\n * - `getKeys` matches prefixes literally: `LIKE … ESCAPE '!'` on Postgres, `GLOB` on SQLite (whose\n * `LIKE` folds ASCII case), and a bytewise range `key >= p AND key < successor(p)` on MySQL (whose\n * range optimizer skips emoji for an indexed `LIKE 'p%'` on a `utf8mb4_bin` key), plus an exact\n * `startsWith` filter everywhere.\n * - Values are written canonically and read as raw JSON text, parsed once (so a stored string that\n * looks like JSON stays a string).\n * - `compareAndSwap` is one conditional `UPDATE` (or a conflict-ignoring `INSERT` for an absent\n * key): `jsonb` equality on Postgres and `JSON` equality on MySQL (both structural), canonical\n * text on SQLite with a structural fallback for rows written before canonicalisation.\n *\n * - MySQL `utf8mb4_bin` keys are PAD SPACE (`\"a \"` = `\"a\"`): reads, removes and swaps match keys\n * byte-exactly, and a write whose key differs from a stored one only by trailing spaces throws\n * {@link KeyCollisionError} instead of overwriting it. `mysqlKvTable(name, { keyCollation:\n * \"utf8mb4_0900_bin\" })` (NO PAD) avoids the collision.\n *\n * `drizzle-orm` is loaded lazily on first use, so importing this subpath never loads the peer.\n *\n * @module\n */\n\nimport type { Column, SQL, Table } from \"drizzle-orm\";\nimport type { DrizzleKvTable } from \"../drizzle/table.ts\";\nimport { canonical, canonicalJson, deepEqual } from \"../internal/json.ts\";\nimport { importPeer } from \"../internal/peer.ts\";\nimport { swapWithFallback } from \"./cas.ts\";\nimport type { CompareAndSwapInput, CompareAndSwapKvStorage } from \"./contract.ts\";\nimport { escapeGlob, escapeLike } from \"./util.ts\";\n\nexport type { DrizzleKvTable } from \"../drizzle/table.ts\";\n\nconst SUBPATH = \"@xtandard/kit/storage/drizzle\";\n\n/** The SQL dialect of a Drizzle database. */\nexport type DrizzleDialect = \"pg\" | \"mysql\" | \"sqlite\";\n\n/**\n * Minimal structural view of a Drizzle database (the query-builder entry points the driver uses).\n * The public `db` option is `unknown` because a dialect-agnostic type cannot match every dialect's\n * builders.\n */\nexport interface DrizzleLikeDatabase {\n /** The dialect object (its class chain names the dialect). */\n dialect?: unknown;\n /** `select(fields).from(table).where(sql)`. */\n select(fields: Record<string, unknown>): {\n from(table: Table): { where(where: SQL): PromiseLike<unknown[]> };\n };\n /** `insert(table)`. */\n insert(table: Table): DrizzleInsert;\n /** `update(table).set(values).where(sql)`. */\n update(table: Table): {\n set(values: Record<string, unknown>): {\n where(where: SQL): PromiseLike<unknown> & {\n returning?(fields: Record<string, Column>): PromiseLike<unknown[]>;\n };\n };\n };\n /** `delete(table).where(sql)`. */\n delete(table: Table): { where(where: SQL): PromiseLike<unknown> };\n}\n\n/** The insert builder surface (upsert methods differ by dialect). */\ninterface DrizzleInsert {\n ignore?(): DrizzleInsert;\n values(row: Record<string, unknown>): PromiseLike<unknown> & {\n onConflictDoUpdate?(config: { target: Column; set: Record<string, unknown> }): DrizzleReturning;\n onConflictDoNothing?(config?: { target?: Column }): DrizzleReturning;\n onDuplicateKeyUpdate?(config: { set: Record<string, unknown> }): PromiseLike<unknown>;\n };\n}\n\ntype DrizzleReturning = PromiseLike<unknown> & {\n returning(fields: Record<string, Column>): PromiseLike<unknown[]>;\n};\n\n/** Drizzle's `entityKind` symbol (`Symbol.for`, so no `drizzle-orm` import is needed). */\nconst ENTITY_KIND = Symbol.for(\"drizzle:entityKind\");\n\nconst DIALECT_KINDS: Record<string, DrizzleDialect> = {\n PgDialect: \"pg\",\n MySqlDialect: \"mysql\",\n SQLiteDialect: \"sqlite\",\n};\n\n/**\n * Detect a Drizzle database's dialect from its `dialect` object's class chain (`PgDialect` /\n * `MySqlDialect` / `SQLite{Sync,Async}Dialect`). Semi-public (ADR 0004).\n */\nexport function detectDrizzleDialect(db: unknown): DrizzleDialect {\n let proto: unknown = (db as DrizzleLikeDatabase | null)?.dialect;\n while (proto) {\n const kind = (proto as { constructor?: Record<symbol, unknown> }).constructor?.[ENTITY_KIND];\n if (typeof kind === \"string\" && kind in DIALECT_KINDS) return DIALECT_KINDS[kind]!;\n proto = Object.getPrototypeOf(proto);\n }\n throw new Error(\n `${SUBPATH}: cannot detect the Drizzle dialect of \\`db\\`; pass \\`dialect: \"pg\" | \"mysql\" | \"sqlite\"\\`.`,\n );\n}\n\n/** Rows affected by a MySQL write, across driver result shapes (mysql2, PlanetScale…). Semi-public. */\nexport function affectedRows(result: unknown): number {\n const header = (Array.isArray(result) ? result[0] : result) as\n | { affectedRows?: number; rowsAffected?: number }\n | undefined;\n return Number(header?.affectedRows ?? header?.rowsAffected ?? 0);\n}\n\ntype SqlTag = typeof import(\"drizzle-orm\").sql;\nlet sqlTag: Promise<SqlTag> | undefined;\n\n/** The `sql` template tag of `drizzle-orm`, imported once (lazily). Semi-public. */\nexport function drizzleSql(): Promise<SqlTag> {\n sqlTag ??= importPeer(\"drizzle-orm\", SUBPATH, () => import(\"drizzle-orm\"))\n .then((m) => m.sql)\n .catch((error: unknown) => {\n sqlTag = undefined;\n throw error;\n });\n return sqlTag;\n}\n\n/**\n * The smallest string greater than every string that starts with `prefix`, in code-point (=\n * `utf8mb4_bin` byte) order: the last code point incremented (skipping surrogates), dropping\n * trailing U+10FFFF. `undefined` when there is none (empty prefix, or all U+10FFFF).\n */\nexport function prefixSuccessor(prefix: string): string | undefined {\n const points = [...prefix].map((c) => c.codePointAt(0)!);\n while (points.length > 0) {\n const last = points.pop()!;\n if (last < 0x10ffff) {\n points.push(last === 0xd7ff ? 0xe000 : last + 1);\n return String.fromCodePoint(...points);\n }\n }\n return undefined;\n}\n\n/**\n * Thrown by `setItem` on MySQL when the key column's collation is PAD SPACE (`utf8mb4_bin`) and the\n * key differs from a stored key only by trailing spaces (`\"a \"` vs `\"a\"`): the write is refused\n * instead of overwriting the other key. The message carries the migration SQL to a NO PAD\n * collation (`utf8mb4_0900_bin`).\n */\nexport class KeyCollisionError extends Error {\n /** The key that was written. */\n readonly key: string;\n /** The stored key it collides with (when it could be read back). */\n readonly storedKey: string | undefined;\n\n constructor(key: string, storedKey: string | undefined, table: DrizzleKvTable) {\n const name = String((table as unknown as Record<symbol, unknown>)[Symbol.for(\"drizzle:Name\")]);\n const type = (table.key as { getSQLType?: () => string }).getSQLType?.() ?? \"varchar(512)\";\n const target = type.replace(/COLLATE\\s+\\w+/i, \"COLLATE utf8mb4_0900_bin\");\n const withCollation = /COLLATE/i.test(target)\n ? target\n : `${target} CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin`;\n super(\n `${SUBPATH}: key ${JSON.stringify(key)} collides with the stored key ${JSON.stringify(storedKey)} ` +\n `in MySQL table \\`${name}\\`: its key column uses a PAD SPACE collation (utf8mb4_bin), which ` +\n \"ignores trailing spaces. Nothing was overwritten. Migrate the column to a NO PAD collation: \" +\n `ALTER TABLE \\`${name}\\` MODIFY \\`key\\` ${withCollation} NOT NULL; ` +\n \"(on MariaDB use utf8mb4_nopad_bin).\",\n );\n this.name = \"KeyCollisionError\";\n this.key = key;\n this.storedKey = storedKey;\n }\n}\n\n/** A MySQL \"invalid JSON text\" error (3141), possibly wrapped by Drizzle in `cause`. */\nfunction isInvalidJsonCast(error: unknown): boolean {\n for (let e: unknown = error, depth = 0; e && depth < 4; depth++) {\n const { errno, code } = e as { errno?: unknown; code?: unknown };\n if (errno === 3141 || code === \"ER_INVALID_JSON_TEXT_IN_PARAM\") return true;\n e = (e as { cause?: unknown }).cause;\n }\n return false;\n}\n\n/** Options for {@link createDrizzleStorage}. */\nexport interface DrizzleStorageOptions {\n /** Your Drizzle database (node-postgres, postgres-js, mysql2, bun:sqlite, libsql, pglite, …). */\n db: unknown;\n /** The KV table, built with a `@xtandard/kit/drizzle/*` factory (or matching its shape). */\n table: DrizzleKvTable;\n /** Override dialect detection (normally read from `db`). */\n dialect?: DrizzleDialect;\n}\n\n/**\n * A compare-and-swap capable storage over a Drizzle table. For change notifications, compose it with\n * `withWatch` and a change source such as `pgListenNotify`.\n */\nexport type DrizzleKvStorage = CompareAndSwapKvStorage;\n\n/**\n * Create a Drizzle-backed {@link DrizzleKvStorage}. No DDL, no connection ownership.\n *\n * @example\n * ```ts\n * import { drizzle } from \"drizzle-orm/node-postgres\";\n * import { createDrizzleStorage } from \"@xtandard/kit/storage/drizzle\";\n * import { pgKvTable } from \"@xtandard/kit/drizzle/pg\";\n *\n * export const kv = pgKvTable(\"xtandard_kv\"); // add to your schema + migrate\n * const storage = createDrizzleStorage({ db: drizzle(pool), table: kv });\n * ```\n */\nexport function createDrizzleStorage(options: DrizzleStorageOptions): DrizzleKvStorage {\n const db = options.db as DrizzleLikeDatabase;\n const { table } = options;\n const dialect = options.dialect ?? detectDrizzleDialect(db);\n\n /** The value column as JSON text, so it is parsed exactly once. */\n const rawValue = (sql: SqlTag): SQL =>\n dialect === \"pg\"\n ? sql`${table.value}::text`\n : dialect === \"mysql\"\n ? sql`cast(${table.value} as char)`\n : sql`cast(${table.value} as text)`;\n\n /**\n * Exact key match. On MySQL also byte-exact: `utf8mb4_bin` is a PAD SPACE collation, so `key = 'a '`\n * would match the row `'a'`.\n */\n const keyIs = (sql: SqlTag, key: string): SQL =>\n dialect === \"mysql\"\n ? sql`${table.key} = ${key} and cast(${table.key} as binary) = cast(${key} as binary)`\n : sql`${table.key} = ${key}`;\n\n /** The stored spelling of the row a PAD SPACE comparison matches for `key`. */\n async function storedSpelling(sql: SqlTag, key: string): Promise<string | undefined> {\n const rows = (await db\n .select({ key: table.key })\n .from(table)\n .where(sql`${table.key} = ${key}`)) as Array<{ key: unknown }>;\n return rows[0] === undefined ? undefined : String(rows[0].key);\n }\n\n async function readRaw(key: string): Promise<string | null> {\n const sql = await drizzleSql();\n const rows = (await db\n .select({ value: rawValue(sql) })\n .from(table)\n .where(keyIs(sql, key))) as Array<{ value: unknown }>;\n const value = rows[0]?.value;\n return typeof value === \"string\" ? value : null;\n }\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const raw = await readRaw(key);\n return raw === null ? null : (JSON.parse(raw) as T);\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n const stored = canonical(value);\n const insert = db.insert(table).values({ key, value: stored });\n if (dialect !== \"mysql\") {\n await insert.onConflictDoUpdate!({ target: table.key, set: { value: stored } });\n return;\n }\n // On a PAD SPACE key column `'a '` hits the row `'a'`: update only a byte-exact match and make\n // a mismatch fail the statement (an invalid JSON cast) instead of overwriting another key.\n // `VALUES()` is deprecated since MySQL 8.0.20 but kept: MariaDB has no row alias (`AS new`).\n const sql = await drizzleSql();\n try {\n await insert.onDuplicateKeyUpdate!({\n set: {\n value: sql`if(cast(${table.key} as binary) = cast(values(${table.key}) as binary), values(${table.value}), cast(concat('kit-key-collision:', values(${table.key})) as json))`,\n },\n });\n } catch (error) {\n if (!isInvalidJsonCast(error)) throw error;\n throw new KeyCollisionError(key, await storedSpelling(sql, key), table);\n }\n },\n\n async removeItem(key: string): Promise<void> {\n const sql = await drizzleSql();\n await db.delete(table).where(keyIs(sql, key));\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n const sql = await drizzleSql();\n const upper = dialect === \"mysql\" ? prefixSuccessor(prefix) : undefined;\n const where =\n dialect === \"sqlite\"\n ? sql`${table.key} glob ${`${escapeGlob(prefix)}*`}`\n : dialect === \"mysql\"\n ? // MySQL's range optimizer skips supplementary characters (emoji) for an indexed\n // `LIKE 'p%'` on a utf8mb4_bin key: match the bytewise range instead.\n upper === undefined\n ? sql`${table.key} >= ${prefix}`\n : sql`${table.key} >= ${prefix} and ${table.key} < ${upper}`\n : sql`${table.key} like ${`${escapeLike(prefix)}%`} escape '!'`;\n const rows = (await db.select({ key: table.key }).from(table).where(where)) as Array<{\n key: unknown;\n }>;\n // A hand-made table with a case/accent-folding collation could over-match.\n return rows.map((row) => String(row.key)).filter((key) => key.startsWith(prefix));\n },\n\n async compareAndSwap<T>(input: CompareAndSwapInput<T>): Promise<boolean> {\n const sql = await drizzleSql();\n const next = canonical(input.next);\n if (input.expected === null) {\n if (dialect === \"mysql\") {\n const result = await db.insert(table).ignore!().values({ key: input.key, value: next });\n return affectedRows(result) === 1;\n }\n const rows = await db.insert(table).values({ key: input.key, value: next })\n .onConflictDoNothing!({ target: table.key }).returning({ key: table.key });\n return rows.length === 1;\n }\n\n /** Swap when the stored value equals `expected` (SQL expression). */\n const swapWhere = async (valueMatches: SQL): Promise<boolean> => {\n const update = db\n .update(table)\n .set({ value: next })\n .where(sql`${keyIs(sql, input.key)} and ${valueMatches}`);\n if (dialect !== \"mysql\") return (await update.returning!({ key: table.key })).length === 1;\n if (affectedRows(await update) === 1) return true;\n // Without CLIENT_FOUND_ROWS, MySQL counts *changed* rows: a swap to an equal value reports 0.\n if (canonicalJson(input.next) !== canonicalJson(input.expected)) return false;\n const raw = await readRaw(input.key);\n return raw !== null && deepEqual(JSON.parse(raw), input.expected);\n };\n\n if (dialect === \"pg\") {\n return swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}::jsonb`);\n }\n if (dialect === \"mysql\") {\n return swapWhere(sql`${table.value} = cast(${canonicalJson(input.expected)} as json)`);\n }\n // SQLite stores text: canonical fast path, then the structural fallback on legacy rows.\n return swapWithFallback<string>(input.expected, {\n fast: () => swapWhere(sql`${table.value} = ${canonicalJson(input.expected)}`),\n async read() {\n const raw = await readRaw(input.key);\n return raw === null ? null : { raw, value: JSON.parse(raw) as unknown };\n },\n swapRaw: (raw) => swapWhere(sql`${table.value} = ${raw}`),\n });\n },\n };\n}\n"],"mappings":"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"}