@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,98 @@
1
+ import { setAuditContext } from "./context.mjs";
2
+ import { t as resolveAuditScope } from "./context-shared-CupikwQo.mjs";
3
+ import { n as createPass, t as auditPanel } from "./elysia-shared-C7geKqPP.mjs";
4
+ import { Elysia, t } from "elysia";
5
+ //#region src/adapters/elysia2.ts
6
+ /**
7
+ * Elysia **2.x** adapter — same surface as `@xtandard/audit/elysia`, built
8
+ * against Elysia 2's types and its `(path, hook, handler)` route order. Use
9
+ * `@xtandard/audit/elysia` for Elysia 1.x.
10
+ *
11
+ * ```ts
12
+ * new Elysia().mount("/audit", auditPanel({ basePath: "/audit", storage }));
13
+ * // or, typed for Eden treaty (`@elysia/eden`):
14
+ * const app = new Elysia().use(auditElysia({ prefix: "/audit", storage }));
15
+ * ```
16
+ *
17
+ * {@link auditContext} is the request-context plugin (ADR 0013). The panel
18
+ * starts the stream runner when `streams` are declared; pass
19
+ * `streamRunner: false` for split deployments.
20
+ *
21
+ * @module
22
+ */
23
+ const tenantParams = t.Object({ tenant: t.String() });
24
+ const eventParams = t.Object({
25
+ tenant: t.String(),
26
+ id: t.String()
27
+ });
28
+ const nameParams = t.Object({ name: t.String() });
29
+ const eventInput = t.Object({
30
+ id: t.Optional(t.String()),
31
+ action: t.String(),
32
+ occurredAt: t.Optional(t.String()),
33
+ actor: t.Optional(t.Any()),
34
+ targets: t.Optional(t.Array(t.Any())),
35
+ context: t.Optional(t.Any()),
36
+ metadata: t.Optional(t.Any()),
37
+ outcome: t.Optional(t.Union([t.Literal("success"), t.Literal("failure")])),
38
+ description: t.Optional(t.String())
39
+ });
40
+ const actionInput = t.Object({
41
+ description: t.Optional(t.String()),
42
+ group: t.Optional(t.String()),
43
+ targets: t.Optional(t.Array(t.String())),
44
+ schema: t.Optional(t.Any()),
45
+ deprecated: t.Optional(t.Boolean())
46
+ });
47
+ /**
48
+ * Typed Elysia plugin exposing the API so the **Eden** client can call it
49
+ * with full path/method/param typing (`client.audit.api.tenants.get()`).
50
+ * Routes are declared for the typed surface; every handler delegates to the
51
+ * shared fetch pipeline (auth, authorization, portal scoping, error mapping
52
+ * reused). A catch-all also serves the bundled UI.
53
+ *
54
+ * Elysia 2.x only — for Elysia 1.x import from `@xtandard/audit/elysia`.
55
+ */
56
+ function auditElysia(options) {
57
+ const { prefix, pass } = createPass(options);
58
+ const tenant = "/api/tenants/:tenant";
59
+ const event = `${tenant}/events/:id`;
60
+ return new Elysia({
61
+ prefix,
62
+ name: "xtandard-audit"
63
+ }).get("/config", pass).get("/api/config", pass).get("/api/openapi.json", pass).get("/api/integrity/keys", pass).get("/api/overview", pass).get("/api/tenants", pass).get(tenant, { params: tenantParams }, pass).get("/api/events", pass).get(`${tenant}/events`, { params: tenantParams }, pass).post(`${tenant}/events`, {
64
+ params: tenantParams,
65
+ body: t.Union([eventInput, t.Array(eventInput)])
66
+ }, pass).get(event, { params: eventParams }, pass).post(`${event}/erase`, {
67
+ params: eventParams,
68
+ body: t.Optional(t.Object({
69
+ sections: t.Optional(t.Array(t.String())),
70
+ reason: t.Optional(t.String())
71
+ }))
72
+ }, pass).get(`${tenant}/export`, { params: tenantParams }, pass).get(`${tenant}/verify`, { params: tenantParams }, pass).get(`${tenant}/checkpoints`, { params: tenantParams }, pass).post(`${tenant}/checkpoints`, { params: tenantParams }, pass).post(`${tenant}/prune`, { params: tenantParams }, pass).post("/api/prune", pass).get("/api/actions", pass).put("/api/actions/:name", {
73
+ params: nameParams,
74
+ body: actionInput
75
+ }, pass).delete("/api/actions/:name", { params: nameParams }, pass).get("/api/streams", pass).post("/api/streams/:name/retry", { params: nameParams }, pass).all("/*", pass);
76
+ }
77
+ /**
78
+ * Request-context plugin: resolves the actor / tenant from Elysia's context
79
+ * (whatever your auth plugin derived) and opens an audit context scope for
80
+ * the handler, so every `audit.record()` inside it is attributed. Register
81
+ * it after the plugin that derives your user.
82
+ *
83
+ * ```ts
84
+ * app.use(auth).use(auditContext({ actor: ({ user }) => user, tenant: ({ user }) => user?.orgId }));
85
+ * ```
86
+ */
87
+ function auditContext(options = {}) {
88
+ return new Elysia().derive("global", async (ctx) => {
89
+ const ip = ctx.server?.requestIP?.(ctx.request)?.address ?? null;
90
+ return { auditScope: await resolveAuditScope(ctx.request, ctx, options, ip) };
91
+ }).onBeforeHandle("global", ({ auditScope }) => {
92
+ setAuditContext(auditScope);
93
+ });
94
+ }
95
+ //#endregion
96
+ export { auditContext, auditElysia, auditPanel };
97
+
98
+ //# sourceMappingURL=entry-elysia2.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-elysia2.mjs","names":[],"sources":["../src/adapters/elysia2.ts"],"sourcesContent":["/**\n * Elysia **2.x** adapter — same surface as `@xtandard/audit/elysia`, built\n * against Elysia 2's types and its `(path, hook, handler)` route order. Use\n * `@xtandard/audit/elysia` for Elysia 1.x.\n *\n * ```ts\n * new Elysia().mount(\"/audit\", auditPanel({ basePath: \"/audit\", storage }));\n * // or, typed for Eden treaty (`@elysia/eden`):\n * const app = new Elysia().use(auditElysia({ prefix: \"/audit\", storage }));\n * ```\n *\n * {@link auditContext} is the request-context plugin (ADR 0013). The panel\n * starts the stream runner when `streams` are declared; pass\n * `streamRunner: false` for split deployments.\n *\n * @module\n */\n\nimport { Elysia, t, type Context } from \"elysia\";\nimport { setAuditContext, type AuditScope } from \"../context.ts\";\nimport type { BunServerLike } from \"./bun.ts\";\nimport { resolveAuditScope, type AuditContextOptions } from \"./context-shared.ts\";\nimport {\n createPass,\n auditPanel,\n type ElysiaAuditHandler,\n type AuditElysiaOptions,\n type AuditPanelOptions,\n} from \"./elysia-shared.ts\";\n\nexport { auditPanel };\nexport type { ElysiaAuditHandler, AuditElysiaOptions, AuditPanelOptions, AuditContextOptions };\n\nconst tenantParams = t.Object({ tenant: t.String() });\nconst eventParams = t.Object({ tenant: t.String(), id: t.String() });\nconst nameParams = t.Object({ name: t.String() });\n\nconst eventInput = t.Object({\n id: t.Optional(t.String()),\n action: t.String(),\n occurredAt: t.Optional(t.String()),\n actor: t.Optional(t.Any()),\n targets: t.Optional(t.Array(t.Any())),\n context: t.Optional(t.Any()),\n metadata: t.Optional(t.Any()),\n outcome: t.Optional(t.Union([t.Literal(\"success\"), t.Literal(\"failure\")])),\n description: t.Optional(t.String()),\n});\n\nconst actionInput = t.Object({\n description: t.Optional(t.String()),\n group: t.Optional(t.String()),\n targets: t.Optional(t.Array(t.String())),\n schema: t.Optional(t.Any()),\n deprecated: t.Optional(t.Boolean()),\n});\n\n/**\n * Typed Elysia plugin exposing the API so the **Eden** client can call it\n * with full path/method/param typing (`client.audit.api.tenants.get()`).\n * Routes are declared for the typed surface; every handler delegates to the\n * shared fetch pipeline (auth, authorization, portal scoping, error mapping\n * reused). A catch-all also serves the bundled UI.\n *\n * Elysia 2.x only — for Elysia 1.x import from `@xtandard/audit/elysia`.\n */\nexport function auditElysia(options: AuditElysiaOptions) {\n const { prefix, pass } = createPass(options);\n\n const tenant = \"/api/tenants/:tenant\";\n const event = `${tenant}/events/:id`;\n\n return new Elysia({ prefix, name: \"xtandard-audit\" })\n .get(\"/config\", pass)\n .get(\"/api/config\", pass)\n .get(\"/api/openapi.json\", pass)\n .get(\"/api/integrity/keys\", pass)\n .get(\"/api/overview\", pass)\n .get(\"/api/tenants\", pass)\n .get(tenant, { params: tenantParams }, pass)\n .get(\"/api/events\", pass)\n .get(`${tenant}/events`, { params: tenantParams }, pass)\n .post(\n `${tenant}/events`,\n {\n params: tenantParams,\n body: t.Union([eventInput, t.Array(eventInput)]),\n },\n pass,\n )\n .get(event, { params: eventParams }, pass)\n .post(\n `${event}/erase`,\n {\n params: eventParams,\n body: t.Optional(\n t.Object({\n sections: t.Optional(t.Array(t.String())),\n reason: t.Optional(t.String()),\n }),\n ),\n },\n pass,\n )\n .get(`${tenant}/export`, { params: tenantParams }, pass)\n .get(`${tenant}/verify`, { params: tenantParams }, pass)\n .get(`${tenant}/checkpoints`, { params: tenantParams }, pass)\n .post(`${tenant}/checkpoints`, { params: tenantParams }, pass)\n .post(`${tenant}/prune`, { params: tenantParams }, pass)\n .post(\"/api/prune\", pass)\n .get(\"/api/actions\", pass)\n .put(\"/api/actions/:name\", { params: nameParams, body: actionInput }, pass)\n .delete(\"/api/actions/:name\", { params: nameParams }, pass)\n .get(\"/api/streams\", pass)\n .post(\"/api/streams/:name/retry\", { params: nameParams }, pass)\n .all(\"/*\", pass); // bundled UI assets + SPA fallback\n}\n\n/** Elysia's request context, plus whatever the host's own plugins derived (e.g. `user`). */\nexport type ElysiaAuditContextCtx = Context & { [key: string]: unknown };\n\n/**\n * Request-context plugin: resolves the actor / tenant from Elysia's context\n * (whatever your auth plugin derived) and opens an audit context scope for\n * the handler, so every `audit.record()` inside it is attributed. Register\n * it after the plugin that derives your user.\n *\n * ```ts\n * app.use(auth).use(auditContext({ actor: ({ user }) => user, tenant: ({ user }) => user?.orgId }));\n * ```\n */\nexport function auditContext(options: AuditContextOptions<ElysiaAuditContextCtx> = {}) {\n return new Elysia()\n .derive(\"global\", async (ctx) => {\n const server = (ctx as { server?: BunServerLike | null }).server;\n const ip = server?.requestIP?.(ctx.request)?.address ?? null;\n const auditScope: AuditScope = await resolveAuditScope(\n ctx.request,\n ctx as ElysiaAuditContextCtx,\n options,\n ip,\n );\n return { auditScope };\n })\n .onBeforeHandle(\"global\", ({ auditScope }) => {\n // Synchronous on purpose: `enterWith` here carries into the handler.\n setAuditContext(auditScope);\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACpD,MAAM,cAAc,EAAE,OAAO;CAAE,QAAQ,EAAE,OAAO;CAAG,IAAI,EAAE,OAAO;AAAE,CAAC;AACnE,MAAM,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAEhD,MAAM,aAAa,EAAE,OAAO;CAC1B,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;CACzB,QAAQ,EAAE,OAAO;CACjB,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC;CACjC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC;CACzB,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;CACpC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC;CAC3B,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;CAC5B,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC;CACzE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;AACpC,CAAC;AAED,MAAM,cAAc,EAAE,OAAO;CAC3B,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;CAClC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;CAC5B,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC;CAC1B,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpC,CAAC;;;;;;;;;;AAWD,SAAgB,YAAY,SAA6B;CACvD,MAAM,EAAE,QAAQ,SAAS,WAAW,OAAO;CAE3C,MAAM,SAAS;CACf,MAAM,QAAQ,GAAG,OAAO;CAExB,OAAO,IAAI,OAAO;EAAE;EAAQ,MAAM;CAAiB,CAAC,EACjD,IAAI,WAAW,IAAI,EACnB,IAAI,eAAe,IAAI,EACvB,IAAI,qBAAqB,IAAI,EAC7B,IAAI,uBAAuB,IAAI,EAC/B,IAAI,iBAAiB,IAAI,EACzB,IAAI,gBAAgB,IAAI,EACxB,IAAI,QAAQ,EAAE,QAAQ,aAAa,GAAG,IAAI,EAC1C,IAAI,eAAe,IAAI,EACvB,IAAI,GAAG,OAAO,UAAU,EAAE,QAAQ,aAAa,GAAG,IAAI,EACtD,KACC,GAAG,OAAO,UACV;EACE,QAAQ;EACR,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,UAAU,CAAC,CAAC;CACjD,GACA,IACF,EACC,IAAI,OAAO,EAAE,QAAQ,YAAY,GAAG,IAAI,EACxC,KACC,GAAG,MAAM,SACT;EACE,QAAQ;EACR,MAAM,EAAE,SACN,EAAE,OAAO;GACP,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;GACxC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;EAC/B,CAAC,CACH;CACF,GACA,IACF,EACC,IAAI,GAAG,OAAO,UAAU,EAAE,QAAQ,aAAa,GAAG,IAAI,EACtD,IAAI,GAAG,OAAO,UAAU,EAAE,QAAQ,aAAa,GAAG,IAAI,EACtD,IAAI,GAAG,OAAO,eAAe,EAAE,QAAQ,aAAa,GAAG,IAAI,EAC3D,KAAK,GAAG,OAAO,eAAe,EAAE,QAAQ,aAAa,GAAG,IAAI,EAC5D,KAAK,GAAG,OAAO,SAAS,EAAE,QAAQ,aAAa,GAAG,IAAI,EACtD,KAAK,cAAc,IAAI,EACvB,IAAI,gBAAgB,IAAI,EACxB,IAAI,sBAAsB;EAAE,QAAQ;EAAY,MAAM;CAAY,GAAG,IAAI,EACzE,OAAO,sBAAsB,EAAE,QAAQ,WAAW,GAAG,IAAI,EACzD,IAAI,gBAAgB,IAAI,EACxB,KAAK,4BAA4B,EAAE,QAAQ,WAAW,GAAG,IAAI,EAC7D,IAAI,MAAM,IAAI;AACnB;;;;;;;;;;;AAeA,SAAgB,aAAa,UAAsD,CAAC,GAAG;CACrF,OAAO,IAAI,OAAO,EACf,OAAO,UAAU,OAAO,QAAQ;EAE/B,MAAM,KADU,IAA0C,QACvC,YAAY,IAAI,OAAO,GAAG,WAAW;EAOxD,OAAO,EAAE,YAAA,MAN4B,kBACnC,IAAI,SACJ,KACA,SACA,EACF,EACoB;CACtB,CAAC,EACA,eAAe,WAAW,EAAE,iBAAiB;EAE5C,gBAAgB,UAAU;CAC5B,CAAC;AACL"}
@@ -0,0 +1,90 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_context = require("./context.cjs");
3
+ const require_create_fetch_handler = require("./create-fetch-handler-D8cTMVX9.cjs");
4
+ const require_context_shared = require("./context-shared-X2ulHHSB.cjs");
5
+ //#region src/adapters/express.ts
6
+ function headersFrom(req) {
7
+ const headers = new Headers();
8
+ for (const [key, value] of Object.entries(req.headers)) {
9
+ if (value === void 0) continue;
10
+ headers.set(key, Array.isArray(value) ? value.join(", ") : value);
11
+ }
12
+ return headers;
13
+ }
14
+ async function readBody(req) {
15
+ const method = (req.method ?? "GET").toUpperCase();
16
+ if (method === "GET" || method === "HEAD") return void 0;
17
+ if (req.readableEnded) {
18
+ const body = req.body;
19
+ if (body === void 0 || body === null) return void 0;
20
+ const text = typeof body === "string" ? body : JSON.stringify(body);
21
+ return new TextEncoder().encode(text);
22
+ }
23
+ const chunks = [];
24
+ for await (const chunk of req) chunks.push(chunk);
25
+ return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : void 0;
26
+ }
27
+ function requestUrl(req) {
28
+ return `${req.protocol || "http"}://${req.get?.("host") ?? req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? "/"}`;
29
+ }
30
+ function toWebRequest(req, body) {
31
+ return new Request(requestUrl(req), {
32
+ method: req.method,
33
+ headers: headersFrom(req),
34
+ body
35
+ });
36
+ }
37
+ /** Write a web `Response` to Express, streaming the body chunk by chunk. */
38
+ async function writeWebResponse(res, response) {
39
+ res.status(response.status);
40
+ response.headers.forEach((value, key) => res.setHeader(key, value));
41
+ if (!response.body) {
42
+ res.end();
43
+ return;
44
+ }
45
+ const reader = response.body.getReader();
46
+ const onClose = () => void reader.cancel().catch(() => void 0);
47
+ res.once("close", onClose);
48
+ try {
49
+ for (;;) {
50
+ const { value, done } = await reader.read();
51
+ if (done) break;
52
+ if (!res.write(value)) await new Promise((resolve) => res.once("drain", resolve));
53
+ }
54
+ res.end();
55
+ } finally {
56
+ res.off("close", onClose);
57
+ }
58
+ }
59
+ /** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
60
+ function auditPanel(options) {
61
+ const handler = require_create_fetch_handler.createFetchHandler(options);
62
+ const middleware = (req, res, next) => {
63
+ (async () => {
64
+ const request = toWebRequest(req, await readBody(req));
65
+ await writeWebResponse(res, await handler.fetch(request));
66
+ })().catch(next);
67
+ };
68
+ return Object.assign(middleware, {
69
+ core: handler.core,
70
+ streams: handler.streams,
71
+ openapi: handler.openapi,
72
+ close: handler.close
73
+ });
74
+ }
75
+ /**
76
+ * Request-context middleware: resolves the actor / tenant from Express's
77
+ * `req` (whatever your auth middleware set, e.g. `req.user`) and calls
78
+ * `next()` inside an audit context scope, so every `audit.record()` in the
79
+ * downstream handlers is attributed. The socket address is the IP fallback.
80
+ */
81
+ function auditContext(options = {}) {
82
+ return (req, _res, next) => {
83
+ require_context_shared.resolveAuditScope(new Request(requestUrl(req), { headers: headersFrom(req) }), req, options, req.socket?.remoteAddress ?? null).then((scope) => require_context.runWithAuditContext(scope, () => next()), next);
84
+ };
85
+ }
86
+ //#endregion
87
+ exports.auditContext = auditContext;
88
+ exports.auditPanel = auditPanel;
89
+
90
+ //# sourceMappingURL=entry-express.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-express.cjs","names":["createFetchHandler","runWithAuditContext"],"sources":["../src/adapters/express.ts"],"sourcesContent":["/**\n * Express adapter. Express predates the web Fetch API, so {@link auditPanel}\n * bridges Node's `req`/`res` to the web-standard handler: it builds a\n * `Request` from the incoming message, runs {@link createFetchHandler}, and\n * **streams** the `Response` back (exports are never buffered in memory). No\n * `express` import at runtime — only its types. {@link auditContext} is the\n * request-context middleware (ADR 0013).\n *\n * Mount the panel BEFORE any body-parser middleware (it reads the raw body):\n *\n * ```ts\n * import express from \"express\";\n * import { auditContext, auditPanel } from \"@xtandard/audit/express\";\n * const app = express();\n * app.use(auditContext({ actor: (req) => req.user, tenant: (req) => req.user?.orgId }));\n * app.use(\"/audit\", auditPanel({ basePath: \"/audit\", storage }));\n * ```\n *\n * The panel starts the stream runner when `streams` are declared; pass\n * `streamRunner: false` for split deployments.\n *\n * @module\n */\n\nimport type { NextFunction, Request as ExRequest, Response as ExResponse } from \"express\";\nimport { runWithAuditContext } from \"../context.ts\";\nimport { createFetchHandler, type AuditPanelOptions } from \"../server/create-fetch-handler.ts\";\nimport { resolveAuditScope, type AuditContextOptions } from \"./context-shared.ts\";\n\n/** An Express request handler with the `core` + `streams` + `openapi` + `close` attached. */\nexport type ExpressAuditHandler = ((\n req: ExRequest,\n res: ExResponse,\n next: NextFunction,\n) => void) & {\n core: ReturnType<typeof createFetchHandler>[\"core\"];\n streams: ReturnType<typeof createFetchHandler>[\"streams\"];\n openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n close: ReturnType<typeof createFetchHandler>[\"close\"];\n};\n\nfunction headersFrom(req: ExRequest): Headers {\n const headers = new Headers();\n for (const [key, value] of Object.entries(req.headers)) {\n if (value === undefined) continue;\n headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n }\n return headers;\n}\n\nasync function readBody(req: ExRequest): Promise<Uint8Array | undefined> {\n const method = (req.method ?? \"GET\").toUpperCase();\n if (method === \"GET\" || method === \"HEAD\") return undefined;\n\n // If an upstream body parser already consumed the stream, re-serialize req.body.\n if (req.readableEnded) {\n const body = (req as { body?: unknown }).body;\n if (body === undefined || body === null) return undefined;\n const text = typeof body === \"string\" ? body : JSON.stringify(body);\n return new TextEncoder().encode(text);\n }\n\n const chunks: Buffer[] = [];\n for await (const chunk of req as AsyncIterable<Buffer>) chunks.push(chunk);\n return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : undefined;\n}\n\nfunction requestUrl(req: ExRequest): string {\n const protocol = req.protocol || \"http\";\n const host = req.get?.(\"host\") ?? req.headers.host ?? \"localhost\";\n // originalUrl preserves the mount prefix (e.g. /audit/api/...) and query string.\n return `${protocol}://${host}${req.originalUrl ?? req.url ?? \"/\"}`;\n}\n\nfunction toWebRequest(req: ExRequest, body: Uint8Array | undefined): Request {\n return new Request(requestUrl(req), {\n method: req.method,\n headers: headersFrom(req),\n // Uint8Array is a valid BodyInit; the cast satisfies TS 5.7's generic typing.\n body: body as BodyInit | undefined,\n });\n}\n\n/** Write a web `Response` to Express, streaming the body chunk by chunk. */\nasync function writeWebResponse(res: ExResponse, response: Response): Promise<void> {\n res.status(response.status);\n response.headers.forEach((value, key) => res.setHeader(key, value));\n if (!response.body) {\n res.end();\n return;\n }\n const reader = response.body.getReader();\n // Stop pulling (and release the export cursor) when the client goes away.\n const onClose = () => void reader.cancel().catch(() => undefined);\n res.once(\"close\", onClose);\n try {\n for (;;) {\n const { value, done } = await reader.read();\n if (done) break;\n if (!res.write(value)) await new Promise<void>((resolve) => res.once(\"drain\", resolve));\n }\n res.end();\n } finally {\n res.off(\"close\", onClose);\n }\n}\n\n/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */\nexport function auditPanel(options: AuditPanelOptions): ExpressAuditHandler {\n const handler = createFetchHandler(options);\n\n const middleware = (req: ExRequest, res: ExResponse, next: NextFunction): void => {\n (async () => {\n const body = await readBody(req);\n const request = toWebRequest(req, body);\n const response = await handler.fetch(request);\n await writeWebResponse(res, response);\n })().catch(next);\n };\n\n return Object.assign(middleware, {\n core: handler.core,\n streams: handler.streams,\n openapi: handler.openapi,\n close: handler.close,\n });\n}\n\n/**\n * Request-context middleware: resolves the actor / tenant from Express's\n * `req` (whatever your auth middleware set, e.g. `req.user`) and calls\n * `next()` inside an audit context scope, so every `audit.record()` in the\n * downstream handlers is attributed. The socket address is the IP fallback.\n */\nexport function auditContext(\n options: AuditContextOptions<ExRequest> = {},\n): (req: ExRequest, res: ExResponse, next: NextFunction) => void {\n return (req, _res, next) => {\n // Headers only — the body stays untouched for downstream parsers.\n const request = new Request(requestUrl(req), { headers: headersFrom(req) });\n resolveAuditScope(request, req, options, req.socket?.remoteAddress ?? null).then(\n (scope) => runWithAuditContext(scope, () => next()),\n next,\n );\n };\n}\n\nexport type { AuditContextOptions, AuditPanelOptions };\n"],"mappings":";;;;;AAyCA,SAAS,YAAY,KAAyB;CAC5C,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,OAAO,GAAG;EACtD,IAAI,UAAU,KAAA,GAAW;EACzB,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK;CAClE;CACA,OAAO;AACT;AAEA,eAAe,SAAS,KAAiD;CACvE,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,IAAI,WAAW,SAAS,WAAW,QAAQ,OAAO,KAAA;CAGlD,IAAI,IAAI,eAAe;EACrB,MAAM,OAAQ,IAA2B;EACzC,IAAI,SAAS,KAAA,KAAa,SAAS,MAAM,OAAO,KAAA;EAChD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI;EAClE,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;CACtC;CAEA,MAAM,SAAmB,CAAC;CAC1B,WAAW,MAAM,SAAS,KAA8B,OAAO,KAAK,KAAK;CACzE,OAAO,OAAO,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA;AACjE;AAEA,SAAS,WAAW,KAAwB;CAI1C,OAAO,GAHU,IAAI,YAAY,OAGd,KAFN,IAAI,MAAM,MAAM,KAAK,IAAI,QAAQ,QAAQ,cAEvB,IAAI,eAAe,IAAI,OAAO;AAC/D;AAEA,SAAS,aAAa,KAAgB,MAAuC;CAC3E,OAAO,IAAI,QAAQ,WAAW,GAAG,GAAG;EAClC,QAAQ,IAAI;EACZ,SAAS,YAAY,GAAG;EAElB;CACR,CAAC;AACH;;AAGA,eAAe,iBAAiB,KAAiB,UAAmC;CAClF,IAAI,OAAO,SAAS,MAAM;CAC1B,SAAS,QAAQ,SAAS,OAAO,QAAQ,IAAI,UAAU,KAAK,KAAK,CAAC;CAClE,IAAI,CAAC,SAAS,MAAM;EAClB,IAAI,IAAI;EACR;CACF;CACA,MAAM,SAAS,SAAS,KAAK,UAAU;CAEvC,MAAM,gBAAgB,KAAK,OAAO,OAAO,EAAE,YAAY,KAAA,CAAS;CAChE,IAAI,KAAK,SAAS,OAAO;CACzB,IAAI;EACF,SAAS;GACP,MAAM,EAAE,OAAO,SAAS,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GACV,IAAI,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,IAAI,SAAe,YAAY,IAAI,KAAK,SAAS,OAAO,CAAC;EACxF;EACA,IAAI,IAAI;CACV,UAAU;EACR,IAAI,IAAI,SAAS,OAAO;CAC1B;AACF;;AAGA,SAAgB,WAAW,SAAiD;CAC1E,MAAM,UAAUA,6BAAAA,mBAAmB,OAAO;CAE1C,MAAM,cAAc,KAAgB,KAAiB,SAA6B;EAChF,CAAC,YAAY;GAEX,MAAM,UAAU,aAAa,KAAK,MADf,SAAS,GAAG,CACO;GAEtC,MAAM,iBAAiB,KAAK,MADL,QAAQ,MAAM,OAAO,CACR;EACtC,GAAG,EAAE,MAAM,IAAI;CACjB;CAEA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,OAAO,QAAQ;CACjB,CAAC;AACH;;;;;;;AAQA,SAAgB,aACd,UAA0C,CAAC,GACoB;CAC/D,QAAQ,KAAK,MAAM,SAAS;EAG1B,uBAAA,kBAAkB,IADE,QAAQ,WAAW,GAAG,GAAG,EAAE,SAAS,YAAY,GAAG,EAAE,CACjD,GAAG,KAAK,SAAS,IAAI,QAAQ,iBAAiB,IAAI,EAAE,MACzE,UAAUC,gBAAAA,oBAAoB,aAAa,KAAK,CAAC,GAClD,IACF;CACF;AACF"}
@@ -0,0 +1,24 @@
1
+ import { r as createFetchHandler, t as AuditPanelOptions } from "./create-fetch-handler-1pXSEhGi.cjs";
2
+ import { t as AuditContextOptions } from "./context-shared-CUq3cSpV.cjs";
3
+ import { NextFunction, Request, Response } from "express";
4
+
5
+ //#region src/adapters/express.d.ts
6
+ /** An Express request handler with the `core` + `streams` + `openapi` + `close` attached. */
7
+ type ExpressAuditHandler = ((req: Request, res: Response, next: NextFunction) => void) & {
8
+ core: ReturnType<typeof createFetchHandler>["core"];
9
+ streams: ReturnType<typeof createFetchHandler>["streams"];
10
+ openapi: ReturnType<typeof createFetchHandler>["openapi"];
11
+ close: ReturnType<typeof createFetchHandler>["close"];
12
+ };
13
+ /** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
14
+ declare function auditPanel(options: AuditPanelOptions): ExpressAuditHandler;
15
+ /**
16
+ * Request-context middleware: resolves the actor / tenant from Express's
17
+ * `req` (whatever your auth middleware set, e.g. `req.user`) and calls
18
+ * `next()` inside an audit context scope, so every `audit.record()` in the
19
+ * downstream handlers is attributed. The socket address is the IP fallback.
20
+ */
21
+ declare function auditContext(options?: AuditContextOptions<Request>): (req: Request, res: Response, next: NextFunction) => void;
22
+ //#endregion
23
+ export { type AuditContextOptions, type AuditPanelOptions, ExpressAuditHandler, auditContext, auditPanel };
24
+ //# sourceMappingURL=entry-express.d.cts.map
@@ -0,0 +1,24 @@
1
+ import { r as createFetchHandler, t as AuditPanelOptions } from "./create-fetch-handler-zioPVS18.mjs";
2
+ import { t as AuditContextOptions } from "./context-shared-AgBWIRUQ.mjs";
3
+ import { NextFunction, Request, Response } from "express";
4
+
5
+ //#region src/adapters/express.d.ts
6
+ /** An Express request handler with the `core` + `streams` + `openapi` + `close` attached. */
7
+ type ExpressAuditHandler = ((req: Request, res: Response, next: NextFunction) => void) & {
8
+ core: ReturnType<typeof createFetchHandler>["core"];
9
+ streams: ReturnType<typeof createFetchHandler>["streams"];
10
+ openapi: ReturnType<typeof createFetchHandler>["openapi"];
11
+ close: ReturnType<typeof createFetchHandler>["close"];
12
+ };
13
+ /** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
14
+ declare function auditPanel(options: AuditPanelOptions): ExpressAuditHandler;
15
+ /**
16
+ * Request-context middleware: resolves the actor / tenant from Express's
17
+ * `req` (whatever your auth middleware set, e.g. `req.user`) and calls
18
+ * `next()` inside an audit context scope, so every `audit.record()` in the
19
+ * downstream handlers is attributed. The socket address is the IP fallback.
20
+ */
21
+ declare function auditContext(options?: AuditContextOptions<Request>): (req: Request, res: Response, next: NextFunction) => void;
22
+ //#endregion
23
+ export { type AuditContextOptions, type AuditPanelOptions, ExpressAuditHandler, auditContext, auditPanel };
24
+ //# sourceMappingURL=entry-express.d.mts.map
@@ -0,0 +1,88 @@
1
+ import { runWithAuditContext } from "./context.mjs";
2
+ import { t as createFetchHandler } from "./create-fetch-handler-BwQQ_IWf.mjs";
3
+ import { t as resolveAuditScope } from "./context-shared-CupikwQo.mjs";
4
+ //#region src/adapters/express.ts
5
+ function headersFrom(req) {
6
+ const headers = new Headers();
7
+ for (const [key, value] of Object.entries(req.headers)) {
8
+ if (value === void 0) continue;
9
+ headers.set(key, Array.isArray(value) ? value.join(", ") : value);
10
+ }
11
+ return headers;
12
+ }
13
+ async function readBody(req) {
14
+ const method = (req.method ?? "GET").toUpperCase();
15
+ if (method === "GET" || method === "HEAD") return void 0;
16
+ if (req.readableEnded) {
17
+ const body = req.body;
18
+ if (body === void 0 || body === null) return void 0;
19
+ const text = typeof body === "string" ? body : JSON.stringify(body);
20
+ return new TextEncoder().encode(text);
21
+ }
22
+ const chunks = [];
23
+ for await (const chunk of req) chunks.push(chunk);
24
+ return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : void 0;
25
+ }
26
+ function requestUrl(req) {
27
+ return `${req.protocol || "http"}://${req.get?.("host") ?? req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? "/"}`;
28
+ }
29
+ function toWebRequest(req, body) {
30
+ return new Request(requestUrl(req), {
31
+ method: req.method,
32
+ headers: headersFrom(req),
33
+ body
34
+ });
35
+ }
36
+ /** Write a web `Response` to Express, streaming the body chunk by chunk. */
37
+ async function writeWebResponse(res, response) {
38
+ res.status(response.status);
39
+ response.headers.forEach((value, key) => res.setHeader(key, value));
40
+ if (!response.body) {
41
+ res.end();
42
+ return;
43
+ }
44
+ const reader = response.body.getReader();
45
+ const onClose = () => void reader.cancel().catch(() => void 0);
46
+ res.once("close", onClose);
47
+ try {
48
+ for (;;) {
49
+ const { value, done } = await reader.read();
50
+ if (done) break;
51
+ if (!res.write(value)) await new Promise((resolve) => res.once("drain", resolve));
52
+ }
53
+ res.end();
54
+ } finally {
55
+ res.off("close", onClose);
56
+ }
57
+ }
58
+ /** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
59
+ function auditPanel(options) {
60
+ const handler = createFetchHandler(options);
61
+ const middleware = (req, res, next) => {
62
+ (async () => {
63
+ const request = toWebRequest(req, await readBody(req));
64
+ await writeWebResponse(res, await handler.fetch(request));
65
+ })().catch(next);
66
+ };
67
+ return Object.assign(middleware, {
68
+ core: handler.core,
69
+ streams: handler.streams,
70
+ openapi: handler.openapi,
71
+ close: handler.close
72
+ });
73
+ }
74
+ /**
75
+ * Request-context middleware: resolves the actor / tenant from Express's
76
+ * `req` (whatever your auth middleware set, e.g. `req.user`) and calls
77
+ * `next()` inside an audit context scope, so every `audit.record()` in the
78
+ * downstream handlers is attributed. The socket address is the IP fallback.
79
+ */
80
+ function auditContext(options = {}) {
81
+ return (req, _res, next) => {
82
+ resolveAuditScope(new Request(requestUrl(req), { headers: headersFrom(req) }), req, options, req.socket?.remoteAddress ?? null).then((scope) => runWithAuditContext(scope, () => next()), next);
83
+ };
84
+ }
85
+ //#endregion
86
+ export { auditContext, auditPanel };
87
+
88
+ //# sourceMappingURL=entry-express.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-express.mjs","names":[],"sources":["../src/adapters/express.ts"],"sourcesContent":["/**\n * Express adapter. Express predates the web Fetch API, so {@link auditPanel}\n * bridges Node's `req`/`res` to the web-standard handler: it builds a\n * `Request` from the incoming message, runs {@link createFetchHandler}, and\n * **streams** the `Response` back (exports are never buffered in memory). No\n * `express` import at runtime — only its types. {@link auditContext} is the\n * request-context middleware (ADR 0013).\n *\n * Mount the panel BEFORE any body-parser middleware (it reads the raw body):\n *\n * ```ts\n * import express from \"express\";\n * import { auditContext, auditPanel } from \"@xtandard/audit/express\";\n * const app = express();\n * app.use(auditContext({ actor: (req) => req.user, tenant: (req) => req.user?.orgId }));\n * app.use(\"/audit\", auditPanel({ basePath: \"/audit\", storage }));\n * ```\n *\n * The panel starts the stream runner when `streams` are declared; pass\n * `streamRunner: false` for split deployments.\n *\n * @module\n */\n\nimport type { NextFunction, Request as ExRequest, Response as ExResponse } from \"express\";\nimport { runWithAuditContext } from \"../context.ts\";\nimport { createFetchHandler, type AuditPanelOptions } from \"../server/create-fetch-handler.ts\";\nimport { resolveAuditScope, type AuditContextOptions } from \"./context-shared.ts\";\n\n/** An Express request handler with the `core` + `streams` + `openapi` + `close` attached. */\nexport type ExpressAuditHandler = ((\n req: ExRequest,\n res: ExResponse,\n next: NextFunction,\n) => void) & {\n core: ReturnType<typeof createFetchHandler>[\"core\"];\n streams: ReturnType<typeof createFetchHandler>[\"streams\"];\n openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n close: ReturnType<typeof createFetchHandler>[\"close\"];\n};\n\nfunction headersFrom(req: ExRequest): Headers {\n const headers = new Headers();\n for (const [key, value] of Object.entries(req.headers)) {\n if (value === undefined) continue;\n headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n }\n return headers;\n}\n\nasync function readBody(req: ExRequest): Promise<Uint8Array | undefined> {\n const method = (req.method ?? \"GET\").toUpperCase();\n if (method === \"GET\" || method === \"HEAD\") return undefined;\n\n // If an upstream body parser already consumed the stream, re-serialize req.body.\n if (req.readableEnded) {\n const body = (req as { body?: unknown }).body;\n if (body === undefined || body === null) return undefined;\n const text = typeof body === \"string\" ? body : JSON.stringify(body);\n return new TextEncoder().encode(text);\n }\n\n const chunks: Buffer[] = [];\n for await (const chunk of req as AsyncIterable<Buffer>) chunks.push(chunk);\n return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : undefined;\n}\n\nfunction requestUrl(req: ExRequest): string {\n const protocol = req.protocol || \"http\";\n const host = req.get?.(\"host\") ?? req.headers.host ?? \"localhost\";\n // originalUrl preserves the mount prefix (e.g. /audit/api/...) and query string.\n return `${protocol}://${host}${req.originalUrl ?? req.url ?? \"/\"}`;\n}\n\nfunction toWebRequest(req: ExRequest, body: Uint8Array | undefined): Request {\n return new Request(requestUrl(req), {\n method: req.method,\n headers: headersFrom(req),\n // Uint8Array is a valid BodyInit; the cast satisfies TS 5.7's generic typing.\n body: body as BodyInit | undefined,\n });\n}\n\n/** Write a web `Response` to Express, streaming the body chunk by chunk. */\nasync function writeWebResponse(res: ExResponse, response: Response): Promise<void> {\n res.status(response.status);\n response.headers.forEach((value, key) => res.setHeader(key, value));\n if (!response.body) {\n res.end();\n return;\n }\n const reader = response.body.getReader();\n // Stop pulling (and release the export cursor) when the client goes away.\n const onClose = () => void reader.cancel().catch(() => undefined);\n res.once(\"close\", onClose);\n try {\n for (;;) {\n const { value, done } = await reader.read();\n if (done) break;\n if (!res.write(value)) await new Promise<void>((resolve) => res.once(\"drain\", resolve));\n }\n res.end();\n } finally {\n res.off(\"close\", onClose);\n }\n}\n\n/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */\nexport function auditPanel(options: AuditPanelOptions): ExpressAuditHandler {\n const handler = createFetchHandler(options);\n\n const middleware = (req: ExRequest, res: ExResponse, next: NextFunction): void => {\n (async () => {\n const body = await readBody(req);\n const request = toWebRequest(req, body);\n const response = await handler.fetch(request);\n await writeWebResponse(res, response);\n })().catch(next);\n };\n\n return Object.assign(middleware, {\n core: handler.core,\n streams: handler.streams,\n openapi: handler.openapi,\n close: handler.close,\n });\n}\n\n/**\n * Request-context middleware: resolves the actor / tenant from Express's\n * `req` (whatever your auth middleware set, e.g. `req.user`) and calls\n * `next()` inside an audit context scope, so every `audit.record()` in the\n * downstream handlers is attributed. The socket address is the IP fallback.\n */\nexport function auditContext(\n options: AuditContextOptions<ExRequest> = {},\n): (req: ExRequest, res: ExResponse, next: NextFunction) => void {\n return (req, _res, next) => {\n // Headers only — the body stays untouched for downstream parsers.\n const request = new Request(requestUrl(req), { headers: headersFrom(req) });\n resolveAuditScope(request, req, options, req.socket?.remoteAddress ?? null).then(\n (scope) => runWithAuditContext(scope, () => next()),\n next,\n );\n };\n}\n\nexport type { AuditContextOptions, AuditPanelOptions };\n"],"mappings":";;;;AAyCA,SAAS,YAAY,KAAyB;CAC5C,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,OAAO,GAAG;EACtD,IAAI,UAAU,KAAA,GAAW;EACzB,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK;CAClE;CACA,OAAO;AACT;AAEA,eAAe,SAAS,KAAiD;CACvE,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,IAAI,WAAW,SAAS,WAAW,QAAQ,OAAO,KAAA;CAGlD,IAAI,IAAI,eAAe;EACrB,MAAM,OAAQ,IAA2B;EACzC,IAAI,SAAS,KAAA,KAAa,SAAS,MAAM,OAAO,KAAA;EAChD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI;EAClE,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;CACtC;CAEA,MAAM,SAAmB,CAAC;CAC1B,WAAW,MAAM,SAAS,KAA8B,OAAO,KAAK,KAAK;CACzE,OAAO,OAAO,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA;AACjE;AAEA,SAAS,WAAW,KAAwB;CAI1C,OAAO,GAHU,IAAI,YAAY,OAGd,KAFN,IAAI,MAAM,MAAM,KAAK,IAAI,QAAQ,QAAQ,cAEvB,IAAI,eAAe,IAAI,OAAO;AAC/D;AAEA,SAAS,aAAa,KAAgB,MAAuC;CAC3E,OAAO,IAAI,QAAQ,WAAW,GAAG,GAAG;EAClC,QAAQ,IAAI;EACZ,SAAS,YAAY,GAAG;EAElB;CACR,CAAC;AACH;;AAGA,eAAe,iBAAiB,KAAiB,UAAmC;CAClF,IAAI,OAAO,SAAS,MAAM;CAC1B,SAAS,QAAQ,SAAS,OAAO,QAAQ,IAAI,UAAU,KAAK,KAAK,CAAC;CAClE,IAAI,CAAC,SAAS,MAAM;EAClB,IAAI,IAAI;EACR;CACF;CACA,MAAM,SAAS,SAAS,KAAK,UAAU;CAEvC,MAAM,gBAAgB,KAAK,OAAO,OAAO,EAAE,YAAY,KAAA,CAAS;CAChE,IAAI,KAAK,SAAS,OAAO;CACzB,IAAI;EACF,SAAS;GACP,MAAM,EAAE,OAAO,SAAS,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GACV,IAAI,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,IAAI,SAAe,YAAY,IAAI,KAAK,SAAS,OAAO,CAAC;EACxF;EACA,IAAI,IAAI;CACV,UAAU;EACR,IAAI,IAAI,SAAS,OAAO;CAC1B;AACF;;AAGA,SAAgB,WAAW,SAAiD;CAC1E,MAAM,UAAU,mBAAmB,OAAO;CAE1C,MAAM,cAAc,KAAgB,KAAiB,SAA6B;EAChF,CAAC,YAAY;GAEX,MAAM,UAAU,aAAa,KAAK,MADf,SAAS,GAAG,CACO;GAEtC,MAAM,iBAAiB,KAAK,MADL,QAAQ,MAAM,OAAO,CACR;EACtC,GAAG,EAAE,MAAM,IAAI;CACjB;CAEA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,OAAO,QAAQ;CACjB,CAAC;AACH;;;;;;;AAQA,SAAgB,aACd,UAA0C,CAAC,GACoB;CAC/D,QAAQ,KAAK,MAAM,SAAS;EAG1B,kBAAkB,IADE,QAAQ,WAAW,GAAG,GAAG,EAAE,SAAS,YAAY,GAAG,EAAE,CACjD,GAAG,KAAK,SAAS,IAAI,QAAQ,iBAAiB,IAAI,EAAE,MACzE,UAAU,oBAAoB,aAAa,KAAK,CAAC,GAClD,IACF;CACF;AACF"}
@@ -0,0 +1,36 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_context = require("./context.cjs");
3
+ const require_create_fetch_handler = require("./create-fetch-handler-D8cTMVX9.cjs");
4
+ const require_context_shared = require("./context-shared-X2ulHHSB.cjs");
5
+ let hono = require("hono");
6
+ //#region src/adapters/hono.ts
7
+ /**
8
+ * Create a Hono sub-app serving the panel. The `core`, the `streams` runner
9
+ * (or `null`), the `openapi()` document builder and `close()` are attached.
10
+ */
11
+ function auditPanel(options) {
12
+ const handler = require_create_fetch_handler.createFetchHandler(options);
13
+ const app = new hono.Hono();
14
+ app.all("*", (c) => handler.fetch(c.req.raw));
15
+ return Object.assign(app, {
16
+ core: handler.core,
17
+ streams: handler.streams,
18
+ openapi: handler.openapi,
19
+ close: handler.close
20
+ });
21
+ }
22
+ /**
23
+ * Request-context middleware: resolves the actor / tenant from Hono's context
24
+ * (whatever your auth middleware set) and runs the rest of the chain inside
25
+ * an audit context scope, so every `audit.record()` downstream is attributed.
26
+ */
27
+ function auditContext(options = {}) {
28
+ return async (c, next) => {
29
+ await require_context.runWithAuditContext(await require_context_shared.resolveAuditScope(c.req.raw, c, options), () => next());
30
+ };
31
+ }
32
+ //#endregion
33
+ exports.auditContext = auditContext;
34
+ exports.auditPanel = auditPanel;
35
+
36
+ //# sourceMappingURL=entry-hono.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-hono.cjs","names":["createFetchHandler","Hono","runWithAuditContext","resolveAuditScope"],"sources":["../src/adapters/hono.ts"],"sourcesContent":["/**\n * Hono adapter. {@link auditPanel} returns a `Hono` instance whose catch-all\n * delegates to the web-standard panel handler, so it composes via\n * `app.route(path, panel)` (responses — including export streams — pass\n * through untouched). {@link auditContext} is the request-context middleware\n * (ADR 0013). The panel starts the stream runner when `streams` are declared;\n * pass `streamRunner: false` for split deployments.\n *\n * ```ts\n * import { auditContext, auditPanel } from \"@xtandard/audit/hono\";\n *\n * app.use(\"*\", auditContext({ actor: (c) => c.get(\"user\"), tenant: (c) => c.get(\"user\")?.orgId }));\n * app.route(\"/audit\", auditPanel({ basePath: \"/audit\", storage }));\n * ```\n *\n * @module\n */\n\nimport type { Context, MiddlewareHandler } from \"hono\";\nimport { Hono } from \"hono\";\nimport { runWithAuditContext } from \"../context.ts\";\nimport { createFetchHandler, type AuditPanelOptions } from \"../server/create-fetch-handler.ts\";\nimport { resolveAuditScope, type AuditContextOptions } from \"./context-shared.ts\";\n\n/**\n * Create a Hono sub-app serving the panel. The `core`, the `streams` runner\n * (or `null`), the `openapi()` document builder and `close()` are attached.\n */\nexport function auditPanel(options: AuditPanelOptions): Hono & {\n core: ReturnType<typeof createFetchHandler>[\"core\"];\n streams: ReturnType<typeof createFetchHandler>[\"streams\"];\n openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n close: ReturnType<typeof createFetchHandler>[\"close\"];\n} {\n const handler = createFetchHandler(options);\n const app = new Hono();\n app.all(\"*\", (c) => handler.fetch(c.req.raw));\n return Object.assign(app, {\n core: handler.core,\n streams: handler.streams,\n openapi: handler.openapi,\n close: handler.close,\n });\n}\n\n/**\n * Request-context middleware: resolves the actor / tenant from Hono's context\n * (whatever your auth middleware set) and runs the rest of the chain inside\n * an audit context scope, so every `audit.record()` downstream is attributed.\n */\nexport function auditContext(options: AuditContextOptions<Context> = {}): MiddlewareHandler {\n return async (c, next) => {\n const scope = await resolveAuditScope(c.req.raw, c, options);\n await runWithAuditContext(scope, () => next());\n };\n}\n\nexport type { AuditContextOptions, AuditPanelOptions };\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,WAAW,SAKzB;CACA,MAAM,UAAUA,6BAAAA,mBAAmB,OAAO;CAC1C,MAAM,MAAM,IAAIC,KAAAA,KAAK;CACrB,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,EAAE,IAAI,GAAG,CAAC;CAC5C,OAAO,OAAO,OAAO,KAAK;EACxB,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,OAAO,QAAQ;CACjB,CAAC;AACH;;;;;;AAOA,SAAgB,aAAa,UAAwC,CAAC,GAAsB;CAC1F,OAAO,OAAO,GAAG,SAAS;EAExB,MAAMC,gBAAAA,oBAAoB,MADNC,uBAAAA,kBAAkB,EAAE,IAAI,KAAK,GAAG,OAAO,SACpB,KAAK,CAAC;CAC/C;AACF"}
@@ -0,0 +1,24 @@
1
+ import { r as createFetchHandler, t as AuditPanelOptions } from "./create-fetch-handler-1pXSEhGi.cjs";
2
+ import { t as AuditContextOptions } from "./context-shared-CUq3cSpV.cjs";
3
+ import { Context, Hono, MiddlewareHandler } from "hono";
4
+
5
+ //#region src/adapters/hono.d.ts
6
+ /**
7
+ * Create a Hono sub-app serving the panel. The `core`, the `streams` runner
8
+ * (or `null`), the `openapi()` document builder and `close()` are attached.
9
+ */
10
+ declare function auditPanel(options: AuditPanelOptions): Hono & {
11
+ core: ReturnType<typeof createFetchHandler>["core"];
12
+ streams: ReturnType<typeof createFetchHandler>["streams"];
13
+ openapi: ReturnType<typeof createFetchHandler>["openapi"];
14
+ close: ReturnType<typeof createFetchHandler>["close"];
15
+ };
16
+ /**
17
+ * Request-context middleware: resolves the actor / tenant from Hono's context
18
+ * (whatever your auth middleware set) and runs the rest of the chain inside
19
+ * an audit context scope, so every `audit.record()` downstream is attributed.
20
+ */
21
+ declare function auditContext(options?: AuditContextOptions<Context>): MiddlewareHandler;
22
+ //#endregion
23
+ export { type AuditContextOptions, type AuditPanelOptions, auditContext, auditPanel };
24
+ //# sourceMappingURL=entry-hono.d.cts.map
@@ -0,0 +1,24 @@
1
+ import { r as createFetchHandler, t as AuditPanelOptions } from "./create-fetch-handler-zioPVS18.mjs";
2
+ import { t as AuditContextOptions } from "./context-shared-AgBWIRUQ.mjs";
3
+ import { Context, Hono, MiddlewareHandler } from "hono";
4
+
5
+ //#region src/adapters/hono.d.ts
6
+ /**
7
+ * Create a Hono sub-app serving the panel. The `core`, the `streams` runner
8
+ * (or `null`), the `openapi()` document builder and `close()` are attached.
9
+ */
10
+ declare function auditPanel(options: AuditPanelOptions): Hono & {
11
+ core: ReturnType<typeof createFetchHandler>["core"];
12
+ streams: ReturnType<typeof createFetchHandler>["streams"];
13
+ openapi: ReturnType<typeof createFetchHandler>["openapi"];
14
+ close: ReturnType<typeof createFetchHandler>["close"];
15
+ };
16
+ /**
17
+ * Request-context middleware: resolves the actor / tenant from Hono's context
18
+ * (whatever your auth middleware set) and runs the rest of the chain inside
19
+ * an audit context scope, so every `audit.record()` downstream is attributed.
20
+ */
21
+ declare function auditContext(options?: AuditContextOptions<Context>): MiddlewareHandler;
22
+ //#endregion
23
+ export { type AuditContextOptions, type AuditPanelOptions, auditContext, auditPanel };
24
+ //# sourceMappingURL=entry-hono.d.mts.map
@@ -0,0 +1,34 @@
1
+ import { runWithAuditContext } from "./context.mjs";
2
+ import { t as createFetchHandler } from "./create-fetch-handler-BwQQ_IWf.mjs";
3
+ import { t as resolveAuditScope } from "./context-shared-CupikwQo.mjs";
4
+ import { Hono } from "hono";
5
+ //#region src/adapters/hono.ts
6
+ /**
7
+ * Create a Hono sub-app serving the panel. The `core`, the `streams` runner
8
+ * (or `null`), the `openapi()` document builder and `close()` are attached.
9
+ */
10
+ function auditPanel(options) {
11
+ const handler = createFetchHandler(options);
12
+ const app = new Hono();
13
+ app.all("*", (c) => handler.fetch(c.req.raw));
14
+ return Object.assign(app, {
15
+ core: handler.core,
16
+ streams: handler.streams,
17
+ openapi: handler.openapi,
18
+ close: handler.close
19
+ });
20
+ }
21
+ /**
22
+ * Request-context middleware: resolves the actor / tenant from Hono's context
23
+ * (whatever your auth middleware set) and runs the rest of the chain inside
24
+ * an audit context scope, so every `audit.record()` downstream is attributed.
25
+ */
26
+ function auditContext(options = {}) {
27
+ return async (c, next) => {
28
+ await runWithAuditContext(await resolveAuditScope(c.req.raw, c, options), () => next());
29
+ };
30
+ }
31
+ //#endregion
32
+ export { auditContext, auditPanel };
33
+
34
+ //# sourceMappingURL=entry-hono.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-hono.mjs","names":[],"sources":["../src/adapters/hono.ts"],"sourcesContent":["/**\n * Hono adapter. {@link auditPanel} returns a `Hono` instance whose catch-all\n * delegates to the web-standard panel handler, so it composes via\n * `app.route(path, panel)` (responses — including export streams — pass\n * through untouched). {@link auditContext} is the request-context middleware\n * (ADR 0013). The panel starts the stream runner when `streams` are declared;\n * pass `streamRunner: false` for split deployments.\n *\n * ```ts\n * import { auditContext, auditPanel } from \"@xtandard/audit/hono\";\n *\n * app.use(\"*\", auditContext({ actor: (c) => c.get(\"user\"), tenant: (c) => c.get(\"user\")?.orgId }));\n * app.route(\"/audit\", auditPanel({ basePath: \"/audit\", storage }));\n * ```\n *\n * @module\n */\n\nimport type { Context, MiddlewareHandler } from \"hono\";\nimport { Hono } from \"hono\";\nimport { runWithAuditContext } from \"../context.ts\";\nimport { createFetchHandler, type AuditPanelOptions } from \"../server/create-fetch-handler.ts\";\nimport { resolveAuditScope, type AuditContextOptions } from \"./context-shared.ts\";\n\n/**\n * Create a Hono sub-app serving the panel. The `core`, the `streams` runner\n * (or `null`), the `openapi()` document builder and `close()` are attached.\n */\nexport function auditPanel(options: AuditPanelOptions): Hono & {\n core: ReturnType<typeof createFetchHandler>[\"core\"];\n streams: ReturnType<typeof createFetchHandler>[\"streams\"];\n openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n close: ReturnType<typeof createFetchHandler>[\"close\"];\n} {\n const handler = createFetchHandler(options);\n const app = new Hono();\n app.all(\"*\", (c) => handler.fetch(c.req.raw));\n return Object.assign(app, {\n core: handler.core,\n streams: handler.streams,\n openapi: handler.openapi,\n close: handler.close,\n });\n}\n\n/**\n * Request-context middleware: resolves the actor / tenant from Hono's context\n * (whatever your auth middleware set) and runs the rest of the chain inside\n * an audit context scope, so every `audit.record()` downstream is attributed.\n */\nexport function auditContext(options: AuditContextOptions<Context> = {}): MiddlewareHandler {\n return async (c, next) => {\n const scope = await resolveAuditScope(c.req.raw, c, options);\n await runWithAuditContext(scope, () => next());\n };\n}\n\nexport type { AuditContextOptions, AuditPanelOptions };\n"],"mappings":";;;;;;;;;AA4BA,SAAgB,WAAW,SAKzB;CACA,MAAM,UAAU,mBAAmB,OAAO;CAC1C,MAAM,MAAM,IAAI,KAAK;CACrB,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,EAAE,IAAI,GAAG,CAAC;CAC5C,OAAO,OAAO,OAAO,KAAK;EACxB,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,OAAO,QAAQ;CACjB,CAAC;AACH;;;;;;AAOA,SAAgB,aAAa,UAAwC,CAAC,GAAsB;CAC1F,OAAO,OAAO,GAAG,SAAS;EAExB,MAAM,oBAAoB,MADN,kBAAkB,EAAE,IAAI,KAAK,GAAG,OAAO,SACpB,KAAK,CAAC;CAC/C;AACF"}
@@ -0,0 +1,22 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ //#region src/hooks/log.ts
3
+ const defaultFormat = (phase, event) => `[@xtandard/audit] ${phase} ${event.type} ${JSON.stringify(event)}`;
4
+ /**
5
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
6
+ * never denies a mutation — it is a pure observer.
7
+ */
8
+ function createLogHook(options = {}) {
9
+ const log = options.log ?? ((line) => console.log(line));
10
+ const format = options.format ?? defaultFormat;
11
+ const hook = { after(event) {
12
+ log(format("after", event));
13
+ } };
14
+ if (options.includeBefore) hook.before = (event) => {
15
+ log(format("before", event));
16
+ };
17
+ return hook;
18
+ }
19
+ //#endregion
20
+ exports.createLogHook = createLogHook;
21
+
22
+ //# sourceMappingURL=entry-hooks-log.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-hooks-log.cjs","names":[],"sources":["../src/hooks/log.ts"],"sourcesContent":["/**\n * `@xtandard/audit/hooks/log` — a reference hook that logs mutation events.\n *\n * The simplest possible consumer of the hooks seam: useful as a starting point\n * for your own `after` side effects, and handy for local debugging or piping\n * admin activity to a log aggregator. Zero dependencies.\n *\n * @example\n * ```ts\n * import { createAuditCore } from \"@xtandard/audit\";\n * import { createLogHook } from \"@xtandard/audit/hooks/log\";\n *\n * createAuditCore({ storage, hooks: createLogHook() });\n * ```\n *\n * @module\n */\n\nimport type { AfterEvent, BeforeEvent, AuditHooks } from \"./contract.ts\";\n\n/** Options for {@link createLogHook}. */\nexport interface LogHookOptions {\n /** Sink for each formatted line. Default: `console.log`. */\n log?: (line: string) => void;\n /** Also log `before` events (default `false` — `after` only). */\n includeBefore?: boolean;\n /**\n * Format a line for an event. Default: a compact\n * `[@xtandard/audit] <phase> <type>` prefix + JSON payload.\n */\n format?: (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent) => string;\n}\n\nconst defaultFormat = (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent): string =>\n `[@xtandard/audit] ${phase} ${event.type} ${JSON.stringify(event)}`;\n\n/**\n * Build a hook that logs each mutation event. Never throws from `before`, so it\n * never denies a mutation — it is a pure observer.\n */\nexport function createLogHook(options: LogHookOptions = {}): AuditHooks {\n const log = options.log ?? ((line: string) => console.log(line));\n const format = options.format ?? defaultFormat;\n const hook: AuditHooks = {\n after(event) {\n log(format(\"after\", event));\n },\n };\n if (options.includeBefore) {\n hook.before = (event) => {\n log(format(\"before\", event));\n };\n }\n return hook;\n}\n"],"mappings":";;AAiCA,MAAM,iBAAiB,OAA2B,UAChD,qBAAqB,MAAM,GAAG,MAAM,KAAK,GAAG,KAAK,UAAU,KAAK;;;;;AAMlE,SAAgB,cAAc,UAA0B,CAAC,GAAe;CACtE,MAAM,MAAM,QAAQ,SAAS,SAAiB,QAAQ,IAAI,IAAI;CAC9D,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAmB,EACvB,MAAM,OAAO;EACX,IAAI,OAAO,SAAS,KAAK,CAAC;CAC5B,EACF;CACA,IAAI,QAAQ,eACV,KAAK,UAAU,UAAU;EACvB,IAAI,OAAO,UAAU,KAAK,CAAC;CAC7B;CAEF,OAAO;AACT"}
@@ -0,0 +1,23 @@
1
+ import { a as BeforeEvent, r as AuditHooks, t as AfterEvent } from "./contract-pU3wGFmo.cjs";
2
+
3
+ //#region src/hooks/log.d.ts
4
+ /** Options for {@link createLogHook}. */
5
+ interface LogHookOptions {
6
+ /** Sink for each formatted line. Default: `console.log`. */
7
+ log?: (line: string) => void;
8
+ /** Also log `before` events (default `false` — `after` only). */
9
+ includeBefore?: boolean;
10
+ /**
11
+ * Format a line for an event. Default: a compact
12
+ * `[@xtandard/audit] <phase> <type>` prefix + JSON payload.
13
+ */
14
+ format?: (phase: "before" | "after", event: BeforeEvent | AfterEvent) => string;
15
+ }
16
+ /**
17
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
18
+ * never denies a mutation — it is a pure observer.
19
+ */
20
+ declare function createLogHook(options?: LogHookOptions): AuditHooks;
21
+ //#endregion
22
+ export { LogHookOptions, createLogHook };
23
+ //# sourceMappingURL=entry-hooks-log.d.cts.map
@@ -0,0 +1,23 @@
1
+ import { a as BeforeEvent, r as AuditHooks, t as AfterEvent } from "./contract-Cht05WYQ.mjs";
2
+
3
+ //#region src/hooks/log.d.ts
4
+ /** Options for {@link createLogHook}. */
5
+ interface LogHookOptions {
6
+ /** Sink for each formatted line. Default: `console.log`. */
7
+ log?: (line: string) => void;
8
+ /** Also log `before` events (default `false` — `after` only). */
9
+ includeBefore?: boolean;
10
+ /**
11
+ * Format a line for an event. Default: a compact
12
+ * `[@xtandard/audit] <phase> <type>` prefix + JSON payload.
13
+ */
14
+ format?: (phase: "before" | "after", event: BeforeEvent | AfterEvent) => string;
15
+ }
16
+ /**
17
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
18
+ * never denies a mutation — it is a pure observer.
19
+ */
20
+ declare function createLogHook(options?: LogHookOptions): AuditHooks;
21
+ //#endregion
22
+ export { LogHookOptions, createLogHook };
23
+ //# sourceMappingURL=entry-hooks-log.d.mts.map
@@ -0,0 +1,21 @@
1
+ //#region src/hooks/log.ts
2
+ const defaultFormat = (phase, event) => `[@xtandard/audit] ${phase} ${event.type} ${JSON.stringify(event)}`;
3
+ /**
4
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
5
+ * never denies a mutation — it is a pure observer.
6
+ */
7
+ function createLogHook(options = {}) {
8
+ const log = options.log ?? ((line) => console.log(line));
9
+ const format = options.format ?? defaultFormat;
10
+ const hook = { after(event) {
11
+ log(format("after", event));
12
+ } };
13
+ if (options.includeBefore) hook.before = (event) => {
14
+ log(format("before", event));
15
+ };
16
+ return hook;
17
+ }
18
+ //#endregion
19
+ export { createLogHook };
20
+
21
+ //# sourceMappingURL=entry-hooks-log.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-hooks-log.mjs","names":[],"sources":["../src/hooks/log.ts"],"sourcesContent":["/**\n * `@xtandard/audit/hooks/log` — a reference hook that logs mutation events.\n *\n * The simplest possible consumer of the hooks seam: useful as a starting point\n * for your own `after` side effects, and handy for local debugging or piping\n * admin activity to a log aggregator. Zero dependencies.\n *\n * @example\n * ```ts\n * import { createAuditCore } from \"@xtandard/audit\";\n * import { createLogHook } from \"@xtandard/audit/hooks/log\";\n *\n * createAuditCore({ storage, hooks: createLogHook() });\n * ```\n *\n * @module\n */\n\nimport type { AfterEvent, BeforeEvent, AuditHooks } from \"./contract.ts\";\n\n/** Options for {@link createLogHook}. */\nexport interface LogHookOptions {\n /** Sink for each formatted line. Default: `console.log`. */\n log?: (line: string) => void;\n /** Also log `before` events (default `false` — `after` only). */\n includeBefore?: boolean;\n /**\n * Format a line for an event. Default: a compact\n * `[@xtandard/audit] <phase> <type>` prefix + JSON payload.\n */\n format?: (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent) => string;\n}\n\nconst defaultFormat = (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent): string =>\n `[@xtandard/audit] ${phase} ${event.type} ${JSON.stringify(event)}`;\n\n/**\n * Build a hook that logs each mutation event. Never throws from `before`, so it\n * never denies a mutation — it is a pure observer.\n */\nexport function createLogHook(options: LogHookOptions = {}): AuditHooks {\n const log = options.log ?? ((line: string) => console.log(line));\n const format = options.format ?? defaultFormat;\n const hook: AuditHooks = {\n after(event) {\n log(format(\"after\", event));\n },\n };\n if (options.includeBefore) {\n hook.before = (event) => {\n log(format(\"before\", event));\n };\n }\n return hook;\n}\n"],"mappings":";AAiCA,MAAM,iBAAiB,OAA2B,UAChD,qBAAqB,MAAM,GAAG,MAAM,KAAK,GAAG,KAAK,UAAU,KAAK;;;;;AAMlE,SAAgB,cAAc,UAA0B,CAAC,GAAe;CACtE,MAAM,MAAM,QAAQ,SAAS,SAAiB,QAAQ,IAAI,IAAI;CAC9D,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAmB,EACvB,MAAM,OAAO;EACX,IAAI,OAAO,SAAS,KAAK,CAAC;CAC5B,EACF;CACA,IAAI,QAAQ,eACV,KAAK,UAAU,UAAU;EACvB,IAAI,OAAO,UAAU,KAAK,CAAC;CAC7B;CAEF,OAAO;AACT"}