@xtandard/audit 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (423) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +386 -2
  3. package/bin/xtandard-audit.mjs +3 -0
  4. package/dist/basic-DU_nPrWV.mjs +176 -0
  5. package/dist/basic-DU_nPrWV.mjs.map +1 -0
  6. package/dist/basic-hcXnMF9X.cjs +199 -0
  7. package/dist/basic-hcXnMF9X.cjs.map +1 -0
  8. package/dist/canonical-BOgkrX9_.d.cts +17 -0
  9. package/dist/canonical-CL7gfwhb.d.mts +17 -0
  10. package/dist/chunk-D7D4PA-g.mjs +13 -0
  11. package/dist/cli.cjs +773 -0
  12. package/dist/cli.cjs.map +1 -0
  13. package/dist/cli.d.cts +46 -0
  14. package/dist/cli.d.mts +46 -0
  15. package/dist/cli.mjs +762 -0
  16. package/dist/cli.mjs.map +1 -0
  17. package/dist/context-BtR9k9Mt.d.mts +52 -0
  18. package/dist/context-CJM87uG8.d.cts +52 -0
  19. package/dist/context-shared-AgBWIRUQ.d.mts +29 -0
  20. package/dist/context-shared-CUq3cSpV.d.cts +29 -0
  21. package/dist/context-shared-CupikwQo.mjs +39 -0
  22. package/dist/context-shared-CupikwQo.mjs.map +1 -0
  23. package/dist/context-shared-X2ulHHSB.cjs +44 -0
  24. package/dist/context-shared-X2ulHHSB.cjs.map +1 -0
  25. package/dist/context.cjs +82 -0
  26. package/dist/context.cjs.map +1 -0
  27. package/dist/context.d.cts +2 -0
  28. package/dist/context.d.mts +2 -0
  29. package/dist/context.mjs +78 -0
  30. package/dist/context.mjs.map +1 -0
  31. package/dist/contract-BljSE-Hx.mjs +33 -0
  32. package/dist/contract-BljSE-Hx.mjs.map +1 -0
  33. package/dist/contract-BmwHIiMR.d.mts +150 -0
  34. package/dist/contract-CWJSYoJl.d.cts +150 -0
  35. package/dist/contract-Cht05WYQ.d.mts +159 -0
  36. package/dist/contract-CqYQzB6e.d.cts +49 -0
  37. package/dist/contract-DYvBNdnR.cjs +74 -0
  38. package/dist/contract-DYvBNdnR.cjs.map +1 -0
  39. package/dist/contract-DlTo4u2t.d.cts +30 -0
  40. package/dist/contract-DlTo4u2t.d.mts +30 -0
  41. package/dist/contract-DsVL5-gy.cjs +50 -0
  42. package/dist/contract-DsVL5-gy.cjs.map +1 -0
  43. package/dist/contract-isM9SjjQ.mjs +39 -0
  44. package/dist/contract-isM9SjjQ.mjs.map +1 -0
  45. package/dist/contract-pU3wGFmo.d.cts +159 -0
  46. package/dist/contract-yPNuFnVy.d.mts +49 -0
  47. package/dist/core-C0ceVOTk.d.cts +513 -0
  48. package/dist/core-CTr7dw0v.cjs +1725 -0
  49. package/dist/core-CTr7dw0v.cjs.map +1 -0
  50. package/dist/core-IdGEbYdM.mjs +1541 -0
  51. package/dist/core-IdGEbYdM.mjs.map +1 -0
  52. package/dist/core-KtEHRScZ.d.mts +513 -0
  53. package/dist/core.cjs +9 -0
  54. package/dist/core.d.cts +2 -0
  55. package/dist/core.d.mts +2 -0
  56. package/dist/core.mjs +2 -0
  57. package/dist/create-fetch-handler-1pXSEhGi.d.cts +311 -0
  58. package/dist/create-fetch-handler-BwQQ_IWf.mjs +2156 -0
  59. package/dist/create-fetch-handler-BwQQ_IWf.mjs.map +1 -0
  60. package/dist/create-fetch-handler-D8cTMVX9.cjs +2232 -0
  61. package/dist/create-fetch-handler-D8cTMVX9.cjs.map +1 -0
  62. package/dist/create-fetch-handler-zioPVS18.d.mts +311 -0
  63. package/dist/elysia-shared-C7geKqPP.mjs +55 -0
  64. package/dist/elysia-shared-C7geKqPP.mjs.map +1 -0
  65. package/dist/elysia-shared-DT4bfekR.d.cts +20 -0
  66. package/dist/elysia-shared-DXyAyGz_.cjs +66 -0
  67. package/dist/elysia-shared-DXyAyGz_.cjs.map +1 -0
  68. package/dist/elysia-shared-DoL5ab52.d.mts +20 -0
  69. package/dist/entry-auth-basic.cjs +5 -0
  70. package/dist/entry-auth-basic.d.cts +83 -0
  71. package/dist/entry-auth-basic.d.mts +83 -0
  72. package/dist/entry-auth-basic.mjs +2 -0
  73. package/dist/entry-auth-delegated.cjs +28 -0
  74. package/dist/entry-auth-delegated.cjs.map +1 -0
  75. package/dist/entry-auth-delegated.d.cts +36 -0
  76. package/dist/entry-auth-delegated.d.mts +36 -0
  77. package/dist/entry-auth-delegated.mjs +27 -0
  78. package/dist/entry-auth-delegated.mjs.map +1 -0
  79. package/dist/entry-auth-none.cjs +4 -0
  80. package/dist/entry-auth-none.d.cts +25 -0
  81. package/dist/entry-auth-none.d.mts +25 -0
  82. package/dist/entry-auth-none.mjs +2 -0
  83. package/dist/entry-authorization-delegated.cjs +28 -0
  84. package/dist/entry-authorization-delegated.cjs.map +1 -0
  85. package/dist/entry-authorization-delegated.d.cts +32 -0
  86. package/dist/entry-authorization-delegated.d.mts +32 -0
  87. package/dist/entry-authorization-delegated.mjs +27 -0
  88. package/dist/entry-authorization-delegated.mjs.map +1 -0
  89. package/dist/entry-authorization-none.cjs +3 -0
  90. package/dist/entry-authorization-none.d.cts +18 -0
  91. package/dist/entry-authorization-none.d.mts +18 -0
  92. package/dist/entry-authorization-none.mjs +2 -0
  93. package/dist/entry-authorization-roles.cjs +8 -0
  94. package/dist/entry-authorization-roles.d.cts +64 -0
  95. package/dist/entry-authorization-roles.d.mts +64 -0
  96. package/dist/entry-authorization-roles.mjs +3 -0
  97. package/dist/entry-bun.cjs +55 -0
  98. package/dist/entry-bun.cjs.map +1 -0
  99. package/dist/entry-bun.d.cts +29 -0
  100. package/dist/entry-bun.d.mts +29 -0
  101. package/dist/entry-bun.mjs +52 -0
  102. package/dist/entry-bun.mjs.map +1 -0
  103. package/dist/entry-drizzle-audit.cjs +191 -0
  104. package/dist/entry-drizzle-audit.cjs.map +1 -0
  105. package/dist/entry-drizzle-audit.d.cts +118 -0
  106. package/dist/entry-drizzle-audit.d.mts +118 -0
  107. package/dist/entry-drizzle-audit.mjs +186 -0
  108. package/dist/entry-drizzle-audit.mjs.map +1 -0
  109. package/dist/entry-drizzle-mysql.cjs +75 -0
  110. package/dist/entry-drizzle-mysql.cjs.map +1 -0
  111. package/dist/entry-drizzle-mysql.d.cts +42 -0
  112. package/dist/entry-drizzle-mysql.d.mts +42 -0
  113. package/dist/entry-drizzle-mysql.mjs +71 -0
  114. package/dist/entry-drizzle-mysql.mjs.map +1 -0
  115. package/dist/entry-drizzle-pg.cjs +82 -0
  116. package/dist/entry-drizzle-pg.cjs.map +1 -0
  117. package/dist/entry-drizzle-pg.d.cts +48 -0
  118. package/dist/entry-drizzle-pg.d.mts +48 -0
  119. package/dist/entry-drizzle-pg.mjs +78 -0
  120. package/dist/entry-drizzle-pg.mjs.map +1 -0
  121. package/dist/entry-drizzle-sqlite.cjs +71 -0
  122. package/dist/entry-drizzle-sqlite.cjs.map +1 -0
  123. package/dist/entry-drizzle-sqlite.d.cts +37 -0
  124. package/dist/entry-drizzle-sqlite.d.mts +37 -0
  125. package/dist/entry-drizzle-sqlite.mjs +67 -0
  126. package/dist/entry-drizzle-sqlite.mjs.map +1 -0
  127. package/dist/entry-elysia.cjs +112 -0
  128. package/dist/entry-elysia.cjs.map +1 -0
  129. package/dist/entry-elysia.d.cts +710 -0
  130. package/dist/entry-elysia.d.mts +710 -0
  131. package/dist/entry-elysia.mjs +109 -0
  132. package/dist/entry-elysia.mjs.map +1 -0
  133. package/dist/entry-elysia2.cjs +101 -0
  134. package/dist/entry-elysia2.cjs.map +1 -0
  135. package/dist/entry-elysia2.d.cts +905 -0
  136. package/dist/entry-elysia2.d.mts +905 -0
  137. package/dist/entry-elysia2.mjs +98 -0
  138. package/dist/entry-elysia2.mjs.map +1 -0
  139. package/dist/entry-express.cjs +90 -0
  140. package/dist/entry-express.cjs.map +1 -0
  141. package/dist/entry-express.d.cts +24 -0
  142. package/dist/entry-express.d.mts +24 -0
  143. package/dist/entry-express.mjs +88 -0
  144. package/dist/entry-express.mjs.map +1 -0
  145. package/dist/entry-hono.cjs +36 -0
  146. package/dist/entry-hono.cjs.map +1 -0
  147. package/dist/entry-hono.d.cts +24 -0
  148. package/dist/entry-hono.d.mts +24 -0
  149. package/dist/entry-hono.mjs +34 -0
  150. package/dist/entry-hono.mjs.map +1 -0
  151. package/dist/entry-hooks-log.cjs +22 -0
  152. package/dist/entry-hooks-log.cjs.map +1 -0
  153. package/dist/entry-hooks-log.d.cts +23 -0
  154. package/dist/entry-hooks-log.d.mts +23 -0
  155. package/dist/entry-hooks-log.mjs +21 -0
  156. package/dist/entry-hooks-log.mjs.map +1 -0
  157. package/dist/entry-sinks-console.cjs +43 -0
  158. package/dist/entry-sinks-console.cjs.map +1 -0
  159. package/dist/entry-sinks-console.d.cts +26 -0
  160. package/dist/entry-sinks-console.d.mts +26 -0
  161. package/dist/entry-sinks-console.mjs +41 -0
  162. package/dist/entry-sinks-console.mjs.map +1 -0
  163. package/dist/entry-sinks-datadog.cjs +97 -0
  164. package/dist/entry-sinks-datadog.cjs.map +1 -0
  165. package/dist/entry-sinks-datadog.d.cts +66 -0
  166. package/dist/entry-sinks-datadog.d.mts +66 -0
  167. package/dist/entry-sinks-datadog.mjs +91 -0
  168. package/dist/entry-sinks-datadog.mjs.map +1 -0
  169. package/dist/entry-sinks-file.cjs +100 -0
  170. package/dist/entry-sinks-file.cjs.map +1 -0
  171. package/dist/entry-sinks-file.d.cts +70 -0
  172. package/dist/entry-sinks-file.d.mts +70 -0
  173. package/dist/entry-sinks-file.mjs +97 -0
  174. package/dist/entry-sinks-file.mjs.map +1 -0
  175. package/dist/entry-sinks-http.cjs +63 -0
  176. package/dist/entry-sinks-http.cjs.map +1 -0
  177. package/dist/entry-sinks-http.d.cts +55 -0
  178. package/dist/entry-sinks-http.d.mts +55 -0
  179. package/dist/entry-sinks-http.mjs +60 -0
  180. package/dist/entry-sinks-http.mjs.map +1 -0
  181. package/dist/entry-sinks-s3.cjs +115 -0
  182. package/dist/entry-sinks-s3.cjs.map +1 -0
  183. package/dist/entry-sinks-s3.d.cts +79 -0
  184. package/dist/entry-sinks-s3.d.mts +79 -0
  185. package/dist/entry-sinks-s3.mjs +112 -0
  186. package/dist/entry-sinks-s3.mjs.map +1 -0
  187. package/dist/entry-sinks-splunk.cjs +80 -0
  188. package/dist/entry-sinks-splunk.cjs.map +1 -0
  189. package/dist/entry-sinks-splunk.d.cts +58 -0
  190. package/dist/entry-sinks-splunk.d.mts +58 -0
  191. package/dist/entry-sinks-splunk.mjs +77 -0
  192. package/dist/entry-sinks-splunk.mjs.map +1 -0
  193. package/dist/entry-sinks-webhook.cjs +130 -0
  194. package/dist/entry-sinks-webhook.cjs.map +1 -0
  195. package/dist/entry-sinks-webhook.d.cts +69 -0
  196. package/dist/entry-sinks-webhook.d.mts +69 -0
  197. package/dist/entry-sinks-webhook.mjs +125 -0
  198. package/dist/entry-sinks-webhook.mjs.map +1 -0
  199. package/dist/entry-sinks-xtandard-webhooks.cjs +64 -0
  200. package/dist/entry-sinks-xtandard-webhooks.cjs.map +1 -0
  201. package/dist/entry-sinks-xtandard-webhooks.d.cts +64 -0
  202. package/dist/entry-sinks-xtandard-webhooks.d.mts +64 -0
  203. package/dist/entry-sinks-xtandard-webhooks.mjs +63 -0
  204. package/dist/entry-sinks-xtandard-webhooks.mjs.map +1 -0
  205. package/dist/entry-storage-cloudflare-kv.cjs +47 -0
  206. package/dist/entry-storage-cloudflare-kv.cjs.map +1 -0
  207. package/dist/entry-storage-cloudflare-kv.d.cts +42 -0
  208. package/dist/entry-storage-cloudflare-kv.d.mts +42 -0
  209. package/dist/entry-storage-cloudflare-kv.mjs +46 -0
  210. package/dist/entry-storage-cloudflare-kv.mjs.map +1 -0
  211. package/dist/entry-storage-drizzle.cjs +228 -0
  212. package/dist/entry-storage-drizzle.cjs.map +1 -0
  213. package/dist/entry-storage-drizzle.d.cts +43 -0
  214. package/dist/entry-storage-drizzle.d.mts +43 -0
  215. package/dist/entry-storage-drizzle.mjs +227 -0
  216. package/dist/entry-storage-drizzle.mjs.map +1 -0
  217. package/dist/entry-storage-file.cjs +175 -0
  218. package/dist/entry-storage-file.cjs.map +1 -0
  219. package/dist/entry-storage-file.d.cts +41 -0
  220. package/dist/entry-storage-file.d.mts +41 -0
  221. package/dist/entry-storage-file.mjs +171 -0
  222. package/dist/entry-storage-file.mjs.map +1 -0
  223. package/dist/entry-storage-libsql.cjs +133 -0
  224. package/dist/entry-storage-libsql.cjs.map +1 -0
  225. package/dist/entry-storage-libsql.d.cts +60 -0
  226. package/dist/entry-storage-libsql.d.mts +60 -0
  227. package/dist/entry-storage-libsql.mjs +132 -0
  228. package/dist/entry-storage-libsql.mjs.map +1 -0
  229. package/dist/entry-storage-memory.cjs +3 -0
  230. package/dist/entry-storage-memory.d.cts +2 -0
  231. package/dist/entry-storage-memory.d.mts +2 -0
  232. package/dist/entry-storage-memory.mjs +2 -0
  233. package/dist/entry-storage-mongodb.cjs +306 -0
  234. package/dist/entry-storage-mongodb.cjs.map +1 -0
  235. package/dist/entry-storage-mongodb.d.cts +65 -0
  236. package/dist/entry-storage-mongodb.d.mts +65 -0
  237. package/dist/entry-storage-mongodb.mjs +304 -0
  238. package/dist/entry-storage-mongodb.mjs.map +1 -0
  239. package/dist/entry-storage-postgres.cjs +261 -0
  240. package/dist/entry-storage-postgres.cjs.map +1 -0
  241. package/dist/entry-storage-postgres.d.cts +66 -0
  242. package/dist/entry-storage-postgres.d.mts +66 -0
  243. package/dist/entry-storage-postgres.mjs +260 -0
  244. package/dist/entry-storage-postgres.mjs.map +1 -0
  245. package/dist/entry-storage-redis.cjs +223 -0
  246. package/dist/entry-storage-redis.cjs.map +1 -0
  247. package/dist/entry-storage-redis.d.cts +77 -0
  248. package/dist/entry-storage-redis.d.mts +77 -0
  249. package/dist/entry-storage-redis.mjs +221 -0
  250. package/dist/entry-storage-redis.mjs.map +1 -0
  251. package/dist/entry-storage-sqlite.cjs +85 -0
  252. package/dist/entry-storage-sqlite.cjs.map +1 -0
  253. package/dist/entry-storage-sqlite.d.cts +40 -0
  254. package/dist/entry-storage-sqlite.d.mts +40 -0
  255. package/dist/entry-storage-sqlite.mjs +84 -0
  256. package/dist/entry-storage-sqlite.mjs.map +1 -0
  257. package/dist/entry-storage-unstorage.cjs +57 -0
  258. package/dist/entry-storage-unstorage.cjs.map +1 -0
  259. package/dist/entry-storage-unstorage.d.cts +29 -0
  260. package/dist/entry-storage-unstorage.d.mts +29 -0
  261. package/dist/entry-storage-unstorage.mjs +56 -0
  262. package/dist/entry-storage-unstorage.mjs.map +1 -0
  263. package/dist/export-B9S-JeYl.mjs +239 -0
  264. package/dist/export-B9S-JeYl.mjs.map +1 -0
  265. package/dist/export-BZq0KCCn.d.mts +70 -0
  266. package/dist/export-DYfMd-ep.cjs +280 -0
  267. package/dist/export-DYfMd-ep.cjs.map +1 -0
  268. package/dist/export-Dh8T8I1p.d.cts +70 -0
  269. package/dist/index.cjs +279 -0
  270. package/dist/index.cjs.map +1 -0
  271. package/dist/index.d.cts +286 -0
  272. package/dist/index.d.mts +284 -0
  273. package/dist/index.mjs +177 -0
  274. package/dist/index.mjs.map +1 -0
  275. package/dist/integrity-BHhjTBNk.cjs +614 -0
  276. package/dist/integrity-BHhjTBNk.cjs.map +1 -0
  277. package/dist/integrity-kfY2DNAi.mjs +483 -0
  278. package/dist/integrity-kfY2DNAi.mjs.map +1 -0
  279. package/dist/memory-CfykUo9W.cjs +155 -0
  280. package/dist/memory-CfykUo9W.cjs.map +1 -0
  281. package/dist/memory-DrR-Tlbf.d.mts +28 -0
  282. package/dist/memory-GG2Nba1D.mjs +150 -0
  283. package/dist/memory-GG2Nba1D.mjs.map +1 -0
  284. package/dist/memory-HpFdlMR_.d.cts +28 -0
  285. package/dist/none-Be7r6kHH.cjs +33 -0
  286. package/dist/none-Be7r6kHH.cjs.map +1 -0
  287. package/dist/none-CGmIIbI8.cjs +49 -0
  288. package/dist/none-CGmIIbI8.cjs.map +1 -0
  289. package/dist/none-CkV5mZsB.mjs +33 -0
  290. package/dist/none-CkV5mZsB.mjs.map +1 -0
  291. package/dist/none-DBeBeU0Z.mjs +23 -0
  292. package/dist/none-DBeBeU0Z.mjs.map +1 -0
  293. package/dist/query-ChGGtlA7.cjs +243 -0
  294. package/dist/query-ChGGtlA7.cjs.map +1 -0
  295. package/dist/query-LvZbyi37.mjs +172 -0
  296. package/dist/query-LvZbyi37.mjs.map +1 -0
  297. package/dist/react.css +1 -0
  298. package/dist/react.js +31936 -0
  299. package/dist/recorder-B3dG3jbd.d.mts +64 -0
  300. package/dist/recorder-CGY7HK29.d.cts +64 -0
  301. package/dist/roles-BARtYLSX.cjs +112 -0
  302. package/dist/roles-BARtYLSX.cjs.map +1 -0
  303. package/dist/roles-D7Pg89IJ.mjs +83 -0
  304. package/dist/roles-D7Pg89IJ.mjs.map +1 -0
  305. package/dist/schema-DmU7Wp0F.d.cts +251 -0
  306. package/dist/schema-DmU7Wp0F.d.mts +251 -0
  307. package/dist/schema.cjs +20 -0
  308. package/dist/schema.cjs.map +1 -0
  309. package/dist/schema.d.cts +2 -0
  310. package/dist/schema.d.mts +2 -0
  311. package/dist/schema.mjs +17 -0
  312. package/dist/schema.mjs.map +1 -0
  313. package/dist/shared-CJOyJKqT.d.mts +20 -0
  314. package/dist/shared-DSDY-V0n.mjs +100 -0
  315. package/dist/shared-DSDY-V0n.mjs.map +1 -0
  316. package/dist/shared-EANCdRqn.d.cts +20 -0
  317. package/dist/shared-OOAq-U4S.cjs +141 -0
  318. package/dist/shared-OOAq-U4S.cjs.map +1 -0
  319. package/dist/sql-B7b6HzGy.cjs +280 -0
  320. package/dist/sql-B7b6HzGy.cjs.map +1 -0
  321. package/dist/sql-COjPyn3F.mjs +209 -0
  322. package/dist/sql-COjPyn3F.mjs.map +1 -0
  323. package/dist/sqlite-event-log-BnoG8eos.cjs +184 -0
  324. package/dist/sqlite-event-log-BnoG8eos.cjs.map +1 -0
  325. package/dist/sqlite-event-log-nXmS2DS_.mjs +179 -0
  326. package/dist/sqlite-event-log-nXmS2DS_.mjs.map +1 -0
  327. package/dist/streams-CRuxOYcb.d.cts +124 -0
  328. package/dist/streams-DU0_gvI8.d.mts +124 -0
  329. package/dist/table-BcarDd10.d.cts +48 -0
  330. package/dist/table-BcarDd10.d.mts +48 -0
  331. package/dist/testing.cjs +189 -0
  332. package/dist/testing.cjs.map +1 -0
  333. package/dist/testing.d.cts +103 -0
  334. package/dist/testing.d.mts +103 -0
  335. package/dist/testing.mjs +185 -0
  336. package/dist/testing.mjs.map +1 -0
  337. package/dist/types-elysia2/adapters/bun.d.ts +47 -0
  338. package/dist/types-elysia2/adapters/context-shared.d.ts +40 -0
  339. package/dist/types-elysia2/adapters/elysia-shared.d.ts +36 -0
  340. package/dist/types-elysia2/adapters/elysia2.d.ts +588 -0
  341. package/dist/types-elysia2/auth/contract.d.ts +26 -0
  342. package/dist/types-elysia2/authorization/contract.d.ts +54 -0
  343. package/dist/types-elysia2/canonical.d.ts +25 -0
  344. package/dist/types-elysia2/context.d.ts +61 -0
  345. package/dist/types-elysia2/core.d.ts +232 -0
  346. package/dist/types-elysia2/duration.d.ts +26 -0
  347. package/dist/types-elysia2/entry-elysia2.d.ts +10 -0
  348. package/dist/types-elysia2/event-log.d.ts +33 -0
  349. package/dist/types-elysia2/export.d.ts +77 -0
  350. package/dist/types-elysia2/hooks/contract.d.ts +177 -0
  351. package/dist/types-elysia2/id.d.ts +27 -0
  352. package/dist/types-elysia2/integrity.d.ts +193 -0
  353. package/dist/types-elysia2/keys.d.ts +91 -0
  354. package/dist/types-elysia2/portal.d.ts +137 -0
  355. package/dist/types-elysia2/query.d.ts +88 -0
  356. package/dist/types-elysia2/schema.d.ts +247 -0
  357. package/dist/types-elysia2/server/base-path.d.ts +15 -0
  358. package/dist/types-elysia2/server/cors.d.ts +36 -0
  359. package/dist/types-elysia2/server/create-fetch-handler.d.ts +140 -0
  360. package/dist/types-elysia2/server/openapi.d.ts +25 -0
  361. package/dist/types-elysia2/server/render-index-html.d.ts +18 -0
  362. package/dist/types-elysia2/server/routes.d.ts +83 -0
  363. package/dist/types-elysia2/server/static-assets.d.ts +13 -0
  364. package/dist/types-elysia2/standard-schema.d.ts +100 -0
  365. package/dist/types-elysia2/storage/contract.d.ts +106 -0
  366. package/dist/types-elysia2/streams.d.ts +134 -0
  367. package/dist/types-elysia2/transforms.d.ts +56 -0
  368. package/dist/types-elysia2/validation.d.ts +48 -0
  369. package/dist/types-react/canonical.d.ts +25 -0
  370. package/dist/types-react/context.d.ts +61 -0
  371. package/dist/types-react/core.d.ts +232 -0
  372. package/dist/types-react/duration.d.ts +26 -0
  373. package/dist/types-react/event-log.d.ts +33 -0
  374. package/dist/types-react/hooks/contract.d.ts +177 -0
  375. package/dist/types-react/id.d.ts +27 -0
  376. package/dist/types-react/integrity.d.ts +193 -0
  377. package/dist/types-react/keys.d.ts +91 -0
  378. package/dist/types-react/query.d.ts +88 -0
  379. package/dist/types-react/react.d.ts +114 -0
  380. package/dist/types-react/schema.d.ts +247 -0
  381. package/dist/types-react/standard-schema.d.ts +100 -0
  382. package/dist/types-react/storage/contract.d.ts +106 -0
  383. package/dist/types-react/streams.d.ts +134 -0
  384. package/dist/types-react/transforms.d.ts +56 -0
  385. package/dist/types-react/ui/App.d.ts +36 -0
  386. package/dist/types-react/ui/api.d.ts +61 -0
  387. package/dist/types-react/ui/components/ActionFilter.d.ts +17 -0
  388. package/dist/types-react/ui/components/ExportMenu.d.ts +13 -0
  389. package/dist/types-react/ui/components/JsonCodeEditor.d.ts +12 -0
  390. package/dist/types-react/ui/components/ThemeToggle.d.ts +2 -0
  391. package/dist/types-react/ui/components/Toast.d.ts +16 -0
  392. package/dist/types-react/ui/components/audit-bits.d.ts +91 -0
  393. package/dist/types-react/ui/components/integrity-bits.d.ts +19 -0
  394. package/dist/types-react/ui/components/primitives.d.ts +50 -0
  395. package/dist/types-react/ui/components/ui-bits.d.ts +22 -0
  396. package/dist/types-react/ui/lib/filters.d.ts +70 -0
  397. package/dist/types-react/ui/lib/format.d.ts +82 -0
  398. package/dist/types-react/ui/lib/nav-guard.d.ts +20 -0
  399. package/dist/types-react/ui/lib/portal-container.d.ts +24 -0
  400. package/dist/types-react/ui/lib/utils.d.ts +3 -0
  401. package/dist/types-react/ui/theme.d.ts +40 -0
  402. package/dist/types-react/ui/types.d.ts +67 -0
  403. package/dist/types-react/ui/views/ActionsView.d.ts +10 -0
  404. package/dist/types-react/ui/views/EventDrawer.d.ts +15 -0
  405. package/dist/types-react/ui/views/EventsView.d.ts +10 -0
  406. package/dist/types-react/ui/views/IntegrityView.d.ts +10 -0
  407. package/dist/types-react/ui/views/OverviewView.d.ts +9 -0
  408. package/dist/types-react/ui/views/StreamsView.d.ts +10 -0
  409. package/dist/types-react/ui/views/TenantsView.d.ts +6 -0
  410. package/dist/types-react/validation.d.ts +48 -0
  411. package/dist/ui/assets/favicon-BSj8MPnj.svg +11 -0
  412. package/dist/ui/assets/index-B-qrQSOM.css +1 -0
  413. package/dist/ui/assets/index-CemlP5hR.js +244 -0
  414. package/dist/ui/index.html +15 -0
  415. package/dist/validation-DFrLESZD.mjs +150 -0
  416. package/dist/validation-DFrLESZD.mjs.map +1 -0
  417. package/dist/validation-lb0YXrxx.cjs +235 -0
  418. package/dist/validation-lb0YXrxx.cjs.map +1 -0
  419. package/dist/verify.cjs +14 -0
  420. package/dist/verify.d.cts +5 -0
  421. package/dist/verify.d.mts +5 -0
  422. package/dist/verify.mjs +3 -0
  423. package/package.json +610 -4
@@ -0,0 +1,66 @@
1
+ import { i as EventLogStorage } from "./contract-CWJSYoJl.cjs";
2
+
3
+ //#region src/storage/postgres.d.ts
4
+ /**
5
+ * Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and
6
+ * `@electric-sql/pglite`'s `PGlite` satisfy this shape.
7
+ */
8
+ interface SqlClient {
9
+ query(text: string, params?: unknown[]): Promise<{
10
+ rows: Array<Record<string, unknown>>;
11
+ }>;
12
+ }
13
+ /** Options for {@link createPostgresStorage}. */
14
+ interface PostgresStorageOptions {
15
+ /**
16
+ * A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.
17
+ * Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.
18
+ */
19
+ client?: SqlClient;
20
+ /**
21
+ * Connection string used to lazily create a `pg` `Pool` (via dynamic import)
22
+ * when no `client` is supplied.
23
+ */
24
+ connectionString?: string;
25
+ /** Alias for {@link PostgresStorageOptions.connectionString}. */
26
+ url?: string;
27
+ /**
28
+ * KV table name (default `"xtandard_audit"`); the event log uses
29
+ * `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.
30
+ */
31
+ table?: string;
32
+ }
33
+ /**
34
+ * A storage backed by Postgres with the native
35
+ * {@link EventLogStorage} capability, plus a `close()` method that ends the
36
+ * underlying pool — but only the one this adapter created. A client you passed
37
+ * in is left for you to manage.
38
+ */
39
+ interface PostgresAuditStorage extends EventLogStorage {
40
+ /** End the underlying pool if this adapter created it. No-op otherwise. */
41
+ close(): Promise<void>;
42
+ }
43
+ /**
44
+ * Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
45
+ * lazily on first use; connection (when using `connectionString`/`url`) is also
46
+ * lazy — the `pg` `Pool` is imported and constructed on the first operation and
47
+ * reused thereafter.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
52
+ *
53
+ * // Via connection string (lazy `pg` Pool):
54
+ * const storage = createPostgresStorage({
55
+ * connectionString: process.env.DATABASE_URL,
56
+ * });
57
+ *
58
+ * // Or with a pre-built pg Pool / PGlite client:
59
+ * // import { PGlite } from "@electric-sql/pglite";
60
+ * // const storage = createPostgresStorage({ client: new PGlite() });
61
+ * ```
62
+ */
63
+ declare function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage;
64
+ //#endregion
65
+ export { PostgresAuditStorage, PostgresStorageOptions, SqlClient, createPostgresStorage };
66
+ //# sourceMappingURL=entry-storage-postgres.d.cts.map
@@ -0,0 +1,66 @@
1
+ import { i as EventLogStorage } from "./contract-BmwHIiMR.mjs";
2
+
3
+ //#region src/storage/postgres.d.ts
4
+ /**
5
+ * Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and
6
+ * `@electric-sql/pglite`'s `PGlite` satisfy this shape.
7
+ */
8
+ interface SqlClient {
9
+ query(text: string, params?: unknown[]): Promise<{
10
+ rows: Array<Record<string, unknown>>;
11
+ }>;
12
+ }
13
+ /** Options for {@link createPostgresStorage}. */
14
+ interface PostgresStorageOptions {
15
+ /**
16
+ * A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.
17
+ * Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.
18
+ */
19
+ client?: SqlClient;
20
+ /**
21
+ * Connection string used to lazily create a `pg` `Pool` (via dynamic import)
22
+ * when no `client` is supplied.
23
+ */
24
+ connectionString?: string;
25
+ /** Alias for {@link PostgresStorageOptions.connectionString}. */
26
+ url?: string;
27
+ /**
28
+ * KV table name (default `"xtandard_audit"`); the event log uses
29
+ * `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.
30
+ */
31
+ table?: string;
32
+ }
33
+ /**
34
+ * A storage backed by Postgres with the native
35
+ * {@link EventLogStorage} capability, plus a `close()` method that ends the
36
+ * underlying pool — but only the one this adapter created. A client you passed
37
+ * in is left for you to manage.
38
+ */
39
+ interface PostgresAuditStorage extends EventLogStorage {
40
+ /** End the underlying pool if this adapter created it. No-op otherwise. */
41
+ close(): Promise<void>;
42
+ }
43
+ /**
44
+ * Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
45
+ * lazily on first use; connection (when using `connectionString`/`url`) is also
46
+ * lazy — the `pg` `Pool` is imported and constructed on the first operation and
47
+ * reused thereafter.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
52
+ *
53
+ * // Via connection string (lazy `pg` Pool):
54
+ * const storage = createPostgresStorage({
55
+ * connectionString: process.env.DATABASE_URL,
56
+ * });
57
+ *
58
+ * // Or with a pre-built pg Pool / PGlite client:
59
+ * // import { PGlite } from "@electric-sql/pglite";
60
+ * // const storage = createPostgresStorage({ client: new PGlite() });
61
+ * ```
62
+ */
63
+ declare function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage;
64
+ //#endregion
65
+ export { PostgresAuditStorage, PostgresStorageOptions, SqlClient, createPostgresStorage };
66
+ //# sourceMappingURL=entry-storage-postgres.d.mts.map
@@ -0,0 +1,260 @@
1
+ import { o as requirePeer, t as ChainConflictError } from "./contract-isM9SjjQ.mjs";
2
+ import { c as eventTableNames, d as parseEvent, f as toQueryResult, l as eventTargets, n as assertSafeIdentifier, o as eventColumns, r as compileEventQuery, s as eventLogDdl, t as assertContiguous, u as isWriteConflict } from "./sql-COjPyn3F.mjs";
3
+ //#region src/storage/postgres.ts
4
+ /**
5
+ * Postgres storage adapter: a key/value table (`key text PRIMARY KEY, value
6
+ * jsonb`) for control data plus the **native event log** (ADR 0005) in
7
+ * `{table}_events` / `{table}_event_targets` (see {@link ./sql}). It works with
8
+ * any client exposing a `query(text, params?)` method that resolves to
9
+ * `{ rows }` — this covers [`pg`](https://github.com/brianc/node-postgres)
10
+ * (`Pool`/`Client`) and the in-process
11
+ * [`@electric-sql/pglite`](https://github.com/electric-sql/pglite) alike. You
12
+ * can pass a pre-built `client`, or a `connectionString`/`url` to lazily create
13
+ * a `pg` `Pool` on first use.
14
+ *
15
+ * The tables are created on demand (`CREATE TABLE IF NOT EXISTS`) the first
16
+ * time any operation runs, guarded by a single promise so concurrent callers
17
+ * only issue the DDL once. Values are stored as `jsonb`; both `pg` and `pglite`
18
+ * return `jsonb` already parsed to JS, but a string is JSON-parsed defensively
19
+ * so either driver works.
20
+ *
21
+ * Every event-log write is a **single statement** (data-modifying CTEs), so it
22
+ * is atomic without a transaction — which keeps the adapter correct on a `pg`
23
+ * `Pool`, where consecutive queries may run on different connections. An
24
+ * append inserts only when the tenant's max seq is the expected one, and the
25
+ * `(tenant, seq)` primary key turns a concurrent writer's race into a
26
+ * {@link ChainConflictError}.
27
+ *
28
+ * @module
29
+ */
30
+ /**
31
+ * Escape LIKE wildcards (`%`, `_`) and the escape char itself in a literal
32
+ * prefix so `getKeys` matches the prefix verbatim. Paired with `ESCAPE '\'`.
33
+ */
34
+ const escapeLike = (literal) => literal.replace(/[\\%_]/g, (c) => `\\${c}`);
35
+ /** `jsonb_to_recordset` column list for event rows. */
36
+ const EVENT_RECORD = `r(tenant text, seq bigint, id text, action text, occurred_at text,
37
+ recorded_at text, actor_id text, actor_type text, outcome text, search text, data jsonb)`;
38
+ const EVENT_COLUMNS = `tenant, seq, id, action, occurred_at, recorded_at, actor_id, actor_type,
39
+ outcome, search, data`;
40
+ /**
41
+ * Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
42
+ * lazily on first use; connection (when using `connectionString`/`url`) is also
43
+ * lazy — the `pg` `Pool` is imported and constructed on the first operation and
44
+ * reused thereafter.
45
+ *
46
+ * @example
47
+ * ```ts
48
+ * import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
49
+ *
50
+ * // Via connection string (lazy `pg` Pool):
51
+ * const storage = createPostgresStorage({
52
+ * connectionString: process.env.DATABASE_URL,
53
+ * });
54
+ *
55
+ * // Or with a pre-built pg Pool / PGlite client:
56
+ * // import { PGlite } from "@electric-sql/pglite";
57
+ * // const storage = createPostgresStorage({ client: new PGlite() });
58
+ * ```
59
+ */
60
+ function createPostgresStorage(options) {
61
+ const table = assertSafeIdentifier(options.table ?? "xtandard_audit");
62
+ const names = eventTableNames(table);
63
+ const { events: ev, targets: tg } = names;
64
+ const connectionString = options.connectionString ?? options.url;
65
+ const ownsClient = !options.client;
66
+ let client = options.client;
67
+ let connecting;
68
+ let ensured;
69
+ /** Resolve a client, creating a `pg` `Pool` on first use when needed. */
70
+ async function getClient() {
71
+ if (client) return client;
72
+ connecting ??= (async () => {
73
+ let Pool;
74
+ try {
75
+ ({Pool} = await import("pg"));
76
+ } catch {
77
+ requirePeer("pg", "storage/postgres");
78
+ }
79
+ client = new Pool({ connectionString });
80
+ return client;
81
+ })();
82
+ try {
83
+ return await connecting;
84
+ } finally {
85
+ connecting = void 0;
86
+ }
87
+ }
88
+ /** Create the backing tables once, before the first operation. */
89
+ async function ensureTable() {
90
+ const c = await getClient();
91
+ ensured ??= (async () => {
92
+ await c.query(`CREATE TABLE IF NOT EXISTS ${table} (key text PRIMARY KEY, value jsonb NOT NULL)`);
93
+ for (const ddl of eventLogDdl("postgres", table)) await c.query(ddl);
94
+ })();
95
+ try {
96
+ await ensured;
97
+ } catch (err) {
98
+ ensured = void 0;
99
+ throw err;
100
+ }
101
+ return c;
102
+ }
103
+ /**
104
+ * Normalise a `jsonb` column value. Both `pg` and `pglite` typically return
105
+ * it already parsed, but parse a string defensively so either driver works.
106
+ */
107
+ const parseValue = (value) => {
108
+ if (typeof value === "string") try {
109
+ return JSON.parse(value);
110
+ } catch {
111
+ return value;
112
+ }
113
+ return value;
114
+ };
115
+ const rows = async (text, params) => (await (await ensureTable()).query(text, params)).rows;
116
+ const one = async (text, params) => {
117
+ const [row] = await rows(text, params);
118
+ return row ? parseEvent(row.data) : null;
119
+ };
120
+ return {
121
+ async getItem(key) {
122
+ const [row] = await rows(`SELECT value FROM ${table} WHERE key = $1`, [key]);
123
+ if (row === void 0 || row.value === null || row.value === void 0) return null;
124
+ return parseValue(row.value);
125
+ },
126
+ async setItem(key, value) {
127
+ await rows(`INSERT INTO ${table} (key, value) VALUES ($1, $2::jsonb)
128
+ ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value`, [key, JSON.stringify(value)]);
129
+ },
130
+ async removeItem(key) {
131
+ await rows(`DELETE FROM ${table} WHERE key = $1`, [key]);
132
+ },
133
+ async getKeys(prefix) {
134
+ return (await rows(`SELECT key FROM ${table} WHERE key LIKE $1 ESCAPE '\\'`, [`${escapeLike(prefix)}%`])).map((row) => String(row.key)).filter((key) => key.startsWith(prefix));
135
+ },
136
+ async appendEvents(tenant, events, { expectedSeq }) {
137
+ if (events.length === 0) return;
138
+ assertContiguous(tenant, events, expectedSeq);
139
+ const eventRows = events.map((e) => {
140
+ const c = eventColumns(e);
141
+ return {
142
+ tenant: c.tenant,
143
+ seq: c.seq,
144
+ id: c.id,
145
+ action: c.action,
146
+ occurred_at: c.occurredAt,
147
+ recorded_at: c.recordedAt,
148
+ actor_id: c.actorId,
149
+ actor_type: c.actorType,
150
+ outcome: c.outcome,
151
+ search: c.search,
152
+ data: e
153
+ };
154
+ });
155
+ const targetRows = events.flatMap((e) => eventTargets(e).map((t) => ({
156
+ seq: e.seq,
157
+ type: t.type,
158
+ target_id: t.targetId
159
+ })));
160
+ let inserted;
161
+ try {
162
+ const [row] = await rows(`WITH head AS (
163
+ SELECT COALESCE(MAX(seq), 0) AS seq FROM ${ev} WHERE tenant = $1
164
+ ), ok AS (
165
+ SELECT 1 FROM head WHERE head.seq = $2 OR head.seq = 0
166
+ ), ins AS (
167
+ INSERT INTO ${ev} (${EVENT_COLUMNS})
168
+ SELECT ${EVENT_COLUMNS} FROM jsonb_to_recordset($3::jsonb) AS ${EVENT_RECORD}
169
+ WHERE EXISTS (SELECT 1 FROM ok)
170
+ RETURNING seq
171
+ ), tgt AS (
172
+ INSERT INTO ${tg} (tenant, seq, type, target_id)
173
+ SELECT $1, r.seq, r.type, r.target_id
174
+ FROM jsonb_to_recordset($4::jsonb) AS r(seq bigint, type text, target_id text)
175
+ WHERE EXISTS (SELECT 1 FROM ok)
176
+ )
177
+ SELECT COUNT(*) AS n FROM ins`, [
178
+ tenant,
179
+ expectedSeq,
180
+ JSON.stringify(eventRows),
181
+ JSON.stringify(targetRows)
182
+ ]);
183
+ inserted = Number(row?.n ?? 0);
184
+ } catch (err) {
185
+ if (isWriteConflict(err)) throw new ChainConflictError(tenant, expectedSeq);
186
+ throw err;
187
+ }
188
+ if (inserted !== events.length) throw new ChainConflictError(tenant, expectedSeq);
189
+ },
190
+ getEvent: (tenant, id) => one(`SELECT data FROM ${ev} WHERE tenant = $1 AND id = $2`, [tenant, id]),
191
+ lastEvent: (tenant) => one(`SELECT data FROM ${ev} WHERE tenant = $1 ORDER BY seq DESC LIMIT 1`, [tenant]),
192
+ async eventsBySeq(tenant, { afterSeq, limit }) {
193
+ return (await rows(`SELECT data FROM ${ev} WHERE tenant = $1 AND seq > $2 ORDER BY seq ASC LIMIT $3`, [
194
+ tenant,
195
+ afterSeq,
196
+ limit
197
+ ])).map((r) => parseEvent(r.data));
198
+ },
199
+ async queryEvents(q) {
200
+ const { sql, args } = compileEventQuery("postgres", names, q);
201
+ return toQueryResult(await rows(sql, args), q.limit);
202
+ },
203
+ async replaceEvent(event) {
204
+ const c = eventColumns(event);
205
+ const targets = eventTargets(event).map((t) => ({
206
+ type: t.type,
207
+ target_id: t.targetId
208
+ }));
209
+ await rows(`WITH upd AS (
210
+ UPDATE ${ev} SET action = $4, occurred_at = $5, recorded_at = $6, actor_id = $7,
211
+ actor_type = $8, outcome = $9, search = $10, data = $11::jsonb
212
+ WHERE tenant = $1 AND seq = $2 AND id = $3
213
+ RETURNING tenant, seq
214
+ ), del AS (
215
+ DELETE FROM ${tg} t USING upd WHERE t.tenant = upd.tenant AND t.seq = upd.seq
216
+ ), ins AS (
217
+ INSERT INTO ${tg} (tenant, seq, type, target_id)
218
+ SELECT upd.tenant, upd.seq, r.type, r.target_id
219
+ FROM upd, jsonb_to_recordset($12::jsonb) AS r(type text, target_id text)
220
+ )
221
+ SELECT COUNT(*) AS n FROM upd`, [
222
+ c.tenant,
223
+ c.seq,
224
+ c.id,
225
+ c.action,
226
+ c.occurredAt,
227
+ c.recordedAt,
228
+ c.actorId,
229
+ c.actorType,
230
+ c.outcome,
231
+ c.search,
232
+ JSON.stringify(event),
233
+ JSON.stringify(targets)
234
+ ]);
235
+ },
236
+ async deleteEventsThrough(tenant, throughSeq) {
237
+ const [row] = await rows(`WITH d AS (
238
+ DELETE FROM ${ev} WHERE tenant = $1 AND seq <= $2 RETURNING 1
239
+ ), dt AS (
240
+ DELETE FROM ${tg} WHERE tenant = $1 AND seq <= $2
241
+ )
242
+ SELECT COUNT(*) AS n FROM d`, [tenant, throughSeq]);
243
+ return Number(row?.n ?? 0);
244
+ },
245
+ async countEvents(tenant) {
246
+ const [row] = tenant !== void 0 ? await rows(`SELECT COUNT(*) AS n FROM ${ev} WHERE tenant = $1`, [tenant]) : await rows(`SELECT COUNT(*) AS n FROM ${ev}`, []);
247
+ return Number(row?.n ?? 0);
248
+ },
249
+ async listEventTenants() {
250
+ return (await rows(`SELECT DISTINCT tenant FROM ${ev} ORDER BY tenant`, [])).map((r) => String(r.tenant));
251
+ },
252
+ async close() {
253
+ if (ownsClient && client?.end) await client.end();
254
+ }
255
+ };
256
+ }
257
+ //#endregion
258
+ export { createPostgresStorage };
259
+
260
+ //# sourceMappingURL=entry-storage-postgres.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-storage-postgres.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["/**\n * Postgres storage adapter: a key/value table (`key text PRIMARY KEY, value\n * jsonb`) for control data plus the **native event log** (ADR 0005) in\n * `{table}_events` / `{table}_event_targets` (see {@link ./sql}). It works with\n * any client exposing a `query(text, params?)` method that resolves to\n * `{ rows }` — this covers [`pg`](https://github.com/brianc/node-postgres)\n * (`Pool`/`Client`) and the in-process\n * [`@electric-sql/pglite`](https://github.com/electric-sql/pglite) alike. You\n * can pass a pre-built `client`, or a `connectionString`/`url` to lazily create\n * a `pg` `Pool` on first use.\n *\n * The tables are created on demand (`CREATE TABLE IF NOT EXISTS`) the first\n * time any operation runs, guarded by a single promise so concurrent callers\n * only issue the DDL once. Values are stored as `jsonb`; both `pg` and `pglite`\n * return `jsonb` already parsed to JS, but a string is JSON-parsed defensively\n * so either driver works.\n *\n * Every event-log write is a **single statement** (data-modifying CTEs), so it\n * is atomic without a transaction — which keeps the adapter correct on a `pg`\n * `Pool`, where consecutive queries may run on different connections. An\n * append inserts only when the tenant's max seq is the expected one, and the\n * `(tenant, seq)` primary key turns a concurrent writer's race into a\n * {@link ChainConflictError}.\n *\n * @module\n */\n\nimport { ChainConflictError, requirePeer } from \"./contract.ts\";\nimport type { EventLogStorage } from \"./contract.ts\";\nimport {\n assertContiguous,\n assertSafeIdentifier,\n compileEventQuery,\n eventColumns,\n eventLogDdl,\n eventTableNames,\n eventTargets,\n isWriteConflict,\n parseEvent,\n toQueryResult,\n} from \"./sql.ts\";\n\n/**\n * Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and\n * `@electric-sql/pglite`'s `PGlite` satisfy this shape.\n */\nexport interface SqlClient {\n query(text: string, params?: unknown[]): Promise<{ rows: Array<Record<string, unknown>> }>;\n}\n\n/** A client this adapter can also shut down (e.g. a `pg` `Pool`). */\ninterface ClosableSqlClient extends SqlClient {\n end?(): Promise<unknown>;\n}\n\n/** Options for {@link createPostgresStorage}. */\nexport interface PostgresStorageOptions {\n /**\n * A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.\n * Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.\n */\n client?: SqlClient;\n /**\n * Connection string used to lazily create a `pg` `Pool` (via dynamic import)\n * when no `client` is supplied.\n */\n connectionString?: string;\n /** Alias for {@link PostgresStorageOptions.connectionString}. */\n url?: string;\n /**\n * KV table name (default `\"xtandard_audit\"`); the event log uses\n * `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.\n */\n table?: string;\n}\n\n/**\n * A storage backed by Postgres with the native\n * {@link EventLogStorage} capability, plus a `close()` method that ends the\n * underlying pool — but only the one this adapter created. A client you passed\n * in is left for you to manage.\n */\nexport interface PostgresAuditStorage extends EventLogStorage {\n /** End the underlying pool if this adapter created it. No-op otherwise. */\n close(): Promise<void>;\n}\n\n/**\n * Escape LIKE wildcards (`%`, `_`) and the escape char itself in a literal\n * prefix so `getKeys` matches the prefix verbatim. Paired with `ESCAPE '\\'`.\n */\nconst escapeLike = (literal: string): string => literal.replace(/[\\\\%_]/g, (c) => `\\\\${c}`);\n\n/** `jsonb_to_recordset` column list for event rows. */\nconst EVENT_RECORD = `r(tenant text, seq bigint, id text, action text, occurred_at text,\n recorded_at text, actor_id text, actor_type text, outcome text, search text, data jsonb)`;\nconst EVENT_COLUMNS = `tenant, seq, id, action, occurred_at, recorded_at, actor_id, actor_type,\n outcome, search, data`;\n\n/**\n * Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created\n * lazily on first use; connection (when using `connectionString`/`url`) is also\n * lazy — the `pg` `Pool` is imported and constructed on the first operation and\n * reused thereafter.\n *\n * @example\n * ```ts\n * import { createPostgresStorage } from \"@xtandard/audit/storage/postgres\";\n *\n * // Via connection string (lazy `pg` Pool):\n * const storage = createPostgresStorage({\n * connectionString: process.env.DATABASE_URL,\n * });\n *\n * // Or with a pre-built pg Pool / PGlite client:\n * // import { PGlite } from \"@electric-sql/pglite\";\n * // const storage = createPostgresStorage({ client: new PGlite() });\n * ```\n */\nexport function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage {\n const table = assertSafeIdentifier(options.table ?? \"xtandard_audit\");\n const names = eventTableNames(table);\n const { events: ev, targets: tg } = names;\n const connectionString = options.connectionString ?? options.url;\n const ownsClient = !options.client;\n\n let client: ClosableSqlClient | undefined = options.client;\n let connecting: Promise<ClosableSqlClient> | undefined;\n let ensured: Promise<void> | undefined;\n\n /** Resolve a client, creating a `pg` `Pool` on first use when needed. */\n async function getClient(): Promise<ClosableSqlClient> {\n if (client) return client;\n connecting ??= (async () => {\n let Pool: new (config: { connectionString?: string }) => ClosableSqlClient;\n try {\n ({ Pool } = (await import(\"pg\")) as unknown as {\n Pool: new (config: { connectionString?: string }) => ClosableSqlClient;\n });\n } catch {\n requirePeer(\"pg\", \"storage/postgres\");\n }\n client = new Pool({ connectionString });\n return client;\n })();\n try {\n return await connecting;\n } finally {\n connecting = undefined;\n }\n }\n\n /** Create the backing tables once, before the first operation. */\n async function ensureTable(): Promise<ClosableSqlClient> {\n const c = await getClient();\n ensured ??= (async () => {\n await c.query(\n `CREATE TABLE IF NOT EXISTS ${table} (key text PRIMARY KEY, value jsonb NOT NULL)`,\n );\n for (const ddl of eventLogDdl(\"postgres\", table)) await c.query(ddl);\n })();\n try {\n await ensured;\n } catch (err) {\n ensured = undefined; // let a later call retry the DDL\n throw err;\n }\n return c;\n }\n\n /**\n * Normalise a `jsonb` column value. Both `pg` and `pglite` typically return\n * it already parsed, but parse a string defensively so either driver works.\n */\n const parseValue = <T>(value: unknown): T => {\n if (typeof value === \"string\") {\n try {\n return JSON.parse(value) as T;\n } catch {\n return value as T;\n }\n }\n return value as T;\n };\n\n const rows = async (text: string, params: unknown[]) =>\n (await (await ensureTable()).query(text, params)).rows;\n\n const one = async (text: string, params: unknown[]) => {\n const [row] = await rows(text, params);\n return row ? parseEvent(row.data) : null;\n };\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const [row] = await rows(`SELECT value FROM ${table} WHERE key = $1`, [key]);\n if (row === undefined || row.value === null || row.value === undefined) return null;\n return parseValue<T>(row.value);\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n await rows(\n `INSERT INTO ${table} (key, value) VALUES ($1, $2::jsonb)\n ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value`,\n [key, JSON.stringify(value)],\n );\n },\n\n async removeItem(key: string): Promise<void> {\n await rows(`DELETE FROM ${table} WHERE key = $1`, [key]);\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n const found = await rows(`SELECT key FROM ${table} WHERE key LIKE $1 ESCAPE '\\\\'`, [\n `${escapeLike(prefix)}%`,\n ]);\n // Exact prefix semantics whatever the column collation.\n return found.map((row) => String(row.key)).filter((key) => key.startsWith(prefix));\n },\n\n // ---- native event log --------------------------------------------------------------------\n\n async appendEvents(tenant, events, { expectedSeq }): Promise<void> {\n if (events.length === 0) return;\n assertContiguous(tenant, events, expectedSeq);\n const eventRows = events.map((e) => {\n const c = eventColumns(e);\n return {\n tenant: c.tenant,\n seq: c.seq,\n id: c.id,\n action: c.action,\n occurred_at: c.occurredAt,\n recorded_at: c.recordedAt,\n actor_id: c.actorId,\n actor_type: c.actorType,\n outcome: c.outcome,\n search: c.search,\n data: e,\n };\n });\n const targetRows = events.flatMap((e) =>\n eventTargets(e).map((t) => ({ seq: e.seq, type: t.type, target_id: t.targetId })),\n );\n let inserted: number;\n try {\n const [row] = await rows(\n `WITH head AS (\n SELECT COALESCE(MAX(seq), 0) AS seq FROM ${ev} WHERE tenant = $1\n ), ok AS (\n SELECT 1 FROM head WHERE head.seq = $2 OR head.seq = 0\n ), ins AS (\n INSERT INTO ${ev} (${EVENT_COLUMNS})\n SELECT ${EVENT_COLUMNS} FROM jsonb_to_recordset($3::jsonb) AS ${EVENT_RECORD}\n WHERE EXISTS (SELECT 1 FROM ok)\n RETURNING seq\n ), tgt AS (\n INSERT INTO ${tg} (tenant, seq, type, target_id)\n SELECT $1, r.seq, r.type, r.target_id\n FROM jsonb_to_recordset($4::jsonb) AS r(seq bigint, type text, target_id text)\n WHERE EXISTS (SELECT 1 FROM ok)\n )\n SELECT COUNT(*) AS n FROM ins`,\n [tenant, expectedSeq, JSON.stringify(eventRows), JSON.stringify(targetRows)],\n );\n inserted = Number(row?.n ?? 0);\n } catch (err) {\n if (isWriteConflict(err)) throw new ChainConflictError(tenant, expectedSeq);\n throw err;\n }\n if (inserted !== events.length) throw new ChainConflictError(tenant, expectedSeq);\n },\n\n getEvent: (tenant, id) =>\n one(`SELECT data FROM ${ev} WHERE tenant = $1 AND id = $2`, [tenant, id]),\n\n lastEvent: (tenant) =>\n one(`SELECT data FROM ${ev} WHERE tenant = $1 ORDER BY seq DESC LIMIT 1`, [tenant]),\n\n async eventsBySeq(tenant, { afterSeq, limit }) {\n const found = await rows(\n `SELECT data FROM ${ev} WHERE tenant = $1 AND seq > $2 ORDER BY seq ASC LIMIT $3`,\n [tenant, afterSeq, limit],\n );\n return found.map((r) => parseEvent(r.data));\n },\n\n async queryEvents(q) {\n const { sql, args } = compileEventQuery(\"postgres\", names, q);\n return toQueryResult(await rows(sql, args), q.limit);\n },\n\n async replaceEvent(event): Promise<void> {\n const c = eventColumns(event);\n const targets = eventTargets(event).map((t) => ({ type: t.type, target_id: t.targetId }));\n // One statement: the UPDATE gates the target rewrite (same tenant/seq/id only).\n await rows(\n `WITH upd AS (\n UPDATE ${ev} SET action = $4, occurred_at = $5, recorded_at = $6, actor_id = $7,\n actor_type = $8, outcome = $9, search = $10, data = $11::jsonb\n WHERE tenant = $1 AND seq = $2 AND id = $3\n RETURNING tenant, seq\n ), del AS (\n DELETE FROM ${tg} t USING upd WHERE t.tenant = upd.tenant AND t.seq = upd.seq\n ), ins AS (\n INSERT INTO ${tg} (tenant, seq, type, target_id)\n SELECT upd.tenant, upd.seq, r.type, r.target_id\n FROM upd, jsonb_to_recordset($12::jsonb) AS r(type text, target_id text)\n )\n SELECT COUNT(*) AS n FROM upd`,\n [\n c.tenant,\n c.seq,\n c.id,\n c.action,\n c.occurredAt,\n c.recordedAt,\n c.actorId,\n c.actorType,\n c.outcome,\n c.search,\n JSON.stringify(event),\n JSON.stringify(targets),\n ],\n );\n },\n\n async deleteEventsThrough(tenant, throughSeq) {\n const [row] = await rows(\n `WITH d AS (\n DELETE FROM ${ev} WHERE tenant = $1 AND seq <= $2 RETURNING 1\n ), dt AS (\n DELETE FROM ${tg} WHERE tenant = $1 AND seq <= $2\n )\n SELECT COUNT(*) AS n FROM d`,\n [tenant, throughSeq],\n );\n return Number(row?.n ?? 0);\n },\n\n async countEvents(tenant) {\n const [row] =\n tenant !== undefined\n ? await rows(`SELECT COUNT(*) AS n FROM ${ev} WHERE tenant = $1`, [tenant])\n : await rows(`SELECT COUNT(*) AS n FROM ${ev}`, []);\n return Number(row?.n ?? 0);\n },\n\n async listEventTenants() {\n const found = await rows(`SELECT DISTINCT tenant FROM ${ev} ORDER BY tenant`, []);\n return found.map((r) => String(r.tenant));\n },\n\n async close(): Promise<void> {\n if (ownsClient && client?.end) await client.end();\n },\n } satisfies PostgresAuditStorage;\n}\n"],"mappings":"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"}
@@ -0,0 +1,223 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_contract = require("./contract-DYvBNdnR.cjs");
3
+ //#region src/storage/redis.ts
4
+ /**
5
+ * Build the compare-and-swap Lua script around a read and a write expression.
6
+ * `KEYS[1]` is the key; `ARGV[1]` is `"1"` when the expected value is `null`
7
+ * (key must be absent); `ARGV[2]` is the expected value as JSON; `ARGV[3]` is
8
+ * the next value as JSON. Returns `1` when swapped, `0` otherwise. Values are
9
+ * compared structurally (decoded with `cjson`), mirroring the memory driver's
10
+ * deep equality.
11
+ */
12
+ function casScript(read, write) {
13
+ return `
14
+ local function eq(a, b)
15
+ if type(a) ~= type(b) then return false end
16
+ if type(a) ~= 'table' then return a == b end
17
+ for k, v in pairs(a) do
18
+ if not eq(v, b[k]) then return false end
19
+ end
20
+ for k in pairs(b) do
21
+ if a[k] == nil then return false end
22
+ end
23
+ return true
24
+ end
25
+ local current = ${read}
26
+ if ARGV[1] == '1' then
27
+ if current then return 0 end
28
+ else
29
+ if not current then return 0 end
30
+ if current ~= ARGV[2] and not eq(cjson.decode(current), cjson.decode(ARGV[2])) then
31
+ return 0
32
+ end
33
+ end
34
+ ${write}
35
+ return 1`;
36
+ }
37
+ /** Plain strings containing JSON — works on any Redis. */
38
+ const stringCodec = {
39
+ async get(c, key) {
40
+ const raw = await c.get(key);
41
+ return raw === null ? null : JSON.parse(raw);
42
+ },
43
+ async set(c, key, value) {
44
+ await c.set(key, JSON.stringify(value));
45
+ },
46
+ casScript: casScript("redis.call('GET', KEYS[1])", "redis.call('SET', KEYS[1], ARGV[3])")
47
+ };
48
+ /** Native RedisJSON documents — requires the JSON module on the server. */
49
+ const jsonCodec = {
50
+ async get(c, key) {
51
+ return await requireJson(c).get(key) ?? null;
52
+ },
53
+ async set(c, key, value) {
54
+ await requireJson(c).set(key, "$", value);
55
+ },
56
+ casScript: casScript("redis.call('JSON.GET', KEYS[1])", "redis.call('JSON.SET', KEYS[1], '$', ARGV[3])")
57
+ };
58
+ function requireJson(c) {
59
+ if (!c.json) throw new Error("createRedisJSONStorage: the client exposes no `json` commands — use node-redis (the `redis` package) v4+, and a server with the RedisJSON module (Redis 8 / Redis Stack).");
60
+ return c.json;
61
+ }
62
+ /**
63
+ * Create a Redis-backed {@link RedisAuditStorage}. Connection is lazy: the
64
+ * client is created/connected on the first storage operation and reused
65
+ * thereafter, guarded by a single connection promise so concurrent calls connect
66
+ * once.
67
+ *
68
+ * @example
69
+ * ```ts
70
+ * import { createRedisStorage } from "@xtandard/audit/storage/redis";
71
+ *
72
+ * const storage = createRedisStorage({
73
+ * url: process.env.REDIS_URL ?? "redis://localhost:6379",
74
+ * prefix: "myapp:audit",
75
+ * onError: (err) => console.error("[audit/redis]", err),
76
+ * });
77
+ *
78
+ * // Disconnect when the process exits:
79
+ * // process.on("SIGTERM", () => storage.close());
80
+ * ```
81
+ */
82
+ function createRedisStorage(options) {
83
+ return buildRedisStorage(options, stringCodec);
84
+ }
85
+ /**
86
+ * Create a Redis-backed {@link RedisAuditStorage} that stores values as native
87
+ * **RedisJSON** documents (`JSON.SET`/`JSON.GET`) instead of strings — making
88
+ * the stored records queryable with JSONPath (`JSON.GET key $.action`) and
89
+ * indexable with RediSearch, while the audit system behaves identically.
90
+ *
91
+ * Requires the JSON module on the server (built into Redis 8; Redis Stack; or
92
+ * `redisjson` loaded). Same options and semantics as {@link createRedisStorage},
93
+ * including lazy connection, `SCAN`-based `getKeys`, keyspace-notification
94
+ * `watch`, and the Lua `compareAndSwap`. **Do not point it at keys written by
95
+ * `createRedisStorage`** (or vice versa) — the underlying types differ and
96
+ * Redis answers `WRONGTYPE`.
97
+ *
98
+ * @example
99
+ * ```ts
100
+ * import { createRedisJSONStorage } from "@xtandard/audit/storage/redis";
101
+ *
102
+ * const storage = createRedisJSONStorage({
103
+ * url: process.env.REDIS_URL ?? "redis://localhost:6379",
104
+ * prefix: "myapp:audit",
105
+ * });
106
+ * // Then, in redis-cli: JSON.GET myapp:audit:aud/t/acme/events/000000000001 $.action
107
+ * ```
108
+ */
109
+ function createRedisJSONStorage(options) {
110
+ return buildRedisStorage(options, jsonCodec);
111
+ }
112
+ /** Shared implementation — connection, prefixing, SCAN, CAS, watch, close. */
113
+ function buildRedisStorage(options, codec) {
114
+ const { url, prefix } = options;
115
+ const fullPrefix = prefix ? `${prefix}:` : "";
116
+ const ownsClient = !options.client;
117
+ let client = options.client;
118
+ let connecting;
119
+ const attachErrorHandler = (c) => {
120
+ c.on?.("error", (err) => options.onError?.(err));
121
+ };
122
+ if (client) attachErrorHandler(client);
123
+ /** Resolve a connected client, creating/connecting on first use. */
124
+ async function getClient() {
125
+ if (client?.isOpen) return client;
126
+ connecting ??= (async () => {
127
+ if (!client) {
128
+ let createClient;
129
+ try {
130
+ ({createClient} = await import("redis"));
131
+ } catch {
132
+ require_contract.requirePeer("redis", "storage/redis");
133
+ }
134
+ client = createClient({
135
+ url,
136
+ disableOfflineQueue: true,
137
+ socket: { reconnectStrategy: (retries) => Math.min(retries * 100, 3e3) }
138
+ });
139
+ attachErrorHandler(client);
140
+ }
141
+ if (!client.isOpen) await client.connect();
142
+ return client;
143
+ })();
144
+ try {
145
+ return await connecting;
146
+ } finally {
147
+ connecting = void 0;
148
+ }
149
+ }
150
+ /** Prepend the namespace to a caller key. */
151
+ const toRedisKey = (key) => `${fullPrefix}${key}`;
152
+ /** Strip the namespace off a Redis key, yielding the caller key. */
153
+ const fromRedisKey = (key) => fullPrefix && key.startsWith(fullPrefix) ? key.slice(fullPrefix.length) : key;
154
+ return {
155
+ async getItem(key) {
156
+ const c = await getClient();
157
+ return await codec.get(c, toRedisKey(key)) ?? null;
158
+ },
159
+ async setItem(key, value) {
160
+ const c = await getClient();
161
+ await codec.set(c, toRedisKey(key), value);
162
+ },
163
+ async removeItem(key) {
164
+ await (await getClient()).del(toRedisKey(key));
165
+ },
166
+ async getKeys(prefix) {
167
+ const c = await getClient();
168
+ const match = `${escapeGlob(toRedisKey(prefix))}*`;
169
+ const out = [];
170
+ for await (const entry of c.scanIterator({
171
+ MATCH: match,
172
+ COUNT: 100
173
+ })) if (Array.isArray(entry)) for (const k of entry) out.push(fromRedisKey(k));
174
+ else out.push(fromRedisKey(entry));
175
+ return out.filter((key) => key.startsWith(prefix));
176
+ },
177
+ async compareAndSwap(input) {
178
+ const swapped = await (await getClient()).eval(codec.casScript, {
179
+ keys: [toRedisKey(input.key)],
180
+ arguments: [
181
+ input.expected === null ? "1" : "0",
182
+ input.expected === null ? "" : JSON.stringify(input.expected),
183
+ JSON.stringify(input.next)
184
+ ]
185
+ });
186
+ return Number(swapped) === 1;
187
+ },
188
+ async watch(prefix, callback) {
189
+ const subscriber = (await getClient()).duplicate();
190
+ attachErrorHandler(subscriber);
191
+ await subscriber.connect();
192
+ const pattern = `__keyspace@*__:${escapeGlob(toRedisKey(prefix))}*`;
193
+ await subscriber.pSubscribe(pattern, (event, channel) => {
194
+ const idx = channel.indexOf("__:");
195
+ if (idx === -1) return;
196
+ const key = fromRedisKey(channel.slice(idx + 3));
197
+ if (!key.startsWith(prefix)) return;
198
+ callback({
199
+ type: event === "del" || event === "expired" ? "remove" : "update",
200
+ key
201
+ });
202
+ });
203
+ return () => {
204
+ subscriber.disconnect();
205
+ };
206
+ },
207
+ async close() {
208
+ if (ownsClient && client?.isOpen) await client.quit();
209
+ }
210
+ };
211
+ }
212
+ /**
213
+ * Escape Redis glob metacharacters (`*`, `?`, `[`, `]`, `\`) so a literal key
214
+ * prefix can be used in `SCAN MATCH` / `PSUBSCRIBE` patterns.
215
+ */
216
+ function escapeGlob(input) {
217
+ return input.replace(/[*?[\]\\]/g, "\\$&");
218
+ }
219
+ //#endregion
220
+ exports.createRedisJSONStorage = createRedisJSONStorage;
221
+ exports.createRedisStorage = createRedisStorage;
222
+
223
+ //# sourceMappingURL=entry-storage-redis.cjs.map