@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.
- package/LICENSE +21 -0
- package/README.md +386 -2
- package/bin/xtandard-audit.mjs +3 -0
- package/dist/basic-DU_nPrWV.mjs +176 -0
- package/dist/basic-DU_nPrWV.mjs.map +1 -0
- package/dist/basic-hcXnMF9X.cjs +199 -0
- package/dist/basic-hcXnMF9X.cjs.map +1 -0
- package/dist/canonical-BOgkrX9_.d.cts +17 -0
- package/dist/canonical-CL7gfwhb.d.mts +17 -0
- package/dist/chunk-D7D4PA-g.mjs +13 -0
- package/dist/cli.cjs +773 -0
- package/dist/cli.cjs.map +1 -0
- package/dist/cli.d.cts +46 -0
- package/dist/cli.d.mts +46 -0
- package/dist/cli.mjs +762 -0
- package/dist/cli.mjs.map +1 -0
- package/dist/context-BtR9k9Mt.d.mts +52 -0
- package/dist/context-CJM87uG8.d.cts +52 -0
- package/dist/context-shared-AgBWIRUQ.d.mts +29 -0
- package/dist/context-shared-CUq3cSpV.d.cts +29 -0
- package/dist/context-shared-CupikwQo.mjs +39 -0
- package/dist/context-shared-CupikwQo.mjs.map +1 -0
- package/dist/context-shared-X2ulHHSB.cjs +44 -0
- package/dist/context-shared-X2ulHHSB.cjs.map +1 -0
- package/dist/context.cjs +82 -0
- package/dist/context.cjs.map +1 -0
- package/dist/context.d.cts +2 -0
- package/dist/context.d.mts +2 -0
- package/dist/context.mjs +78 -0
- package/dist/context.mjs.map +1 -0
- package/dist/contract-BljSE-Hx.mjs +33 -0
- package/dist/contract-BljSE-Hx.mjs.map +1 -0
- package/dist/contract-BmwHIiMR.d.mts +150 -0
- package/dist/contract-CWJSYoJl.d.cts +150 -0
- package/dist/contract-Cht05WYQ.d.mts +159 -0
- package/dist/contract-CqYQzB6e.d.cts +49 -0
- package/dist/contract-DYvBNdnR.cjs +74 -0
- package/dist/contract-DYvBNdnR.cjs.map +1 -0
- package/dist/contract-DlTo4u2t.d.cts +30 -0
- package/dist/contract-DlTo4u2t.d.mts +30 -0
- package/dist/contract-DsVL5-gy.cjs +50 -0
- package/dist/contract-DsVL5-gy.cjs.map +1 -0
- package/dist/contract-isM9SjjQ.mjs +39 -0
- package/dist/contract-isM9SjjQ.mjs.map +1 -0
- package/dist/contract-pU3wGFmo.d.cts +159 -0
- package/dist/contract-yPNuFnVy.d.mts +49 -0
- package/dist/core-C0ceVOTk.d.cts +513 -0
- package/dist/core-CTr7dw0v.cjs +1725 -0
- package/dist/core-CTr7dw0v.cjs.map +1 -0
- package/dist/core-IdGEbYdM.mjs +1541 -0
- package/dist/core-IdGEbYdM.mjs.map +1 -0
- package/dist/core-KtEHRScZ.d.mts +513 -0
- package/dist/core.cjs +9 -0
- package/dist/core.d.cts +2 -0
- package/dist/core.d.mts +2 -0
- package/dist/core.mjs +2 -0
- package/dist/create-fetch-handler-1pXSEhGi.d.cts +311 -0
- package/dist/create-fetch-handler-BwQQ_IWf.mjs +2156 -0
- package/dist/create-fetch-handler-BwQQ_IWf.mjs.map +1 -0
- package/dist/create-fetch-handler-D8cTMVX9.cjs +2232 -0
- package/dist/create-fetch-handler-D8cTMVX9.cjs.map +1 -0
- package/dist/create-fetch-handler-zioPVS18.d.mts +311 -0
- package/dist/elysia-shared-C7geKqPP.mjs +55 -0
- package/dist/elysia-shared-C7geKqPP.mjs.map +1 -0
- package/dist/elysia-shared-DT4bfekR.d.cts +20 -0
- package/dist/elysia-shared-DXyAyGz_.cjs +66 -0
- package/dist/elysia-shared-DXyAyGz_.cjs.map +1 -0
- package/dist/elysia-shared-DoL5ab52.d.mts +20 -0
- package/dist/entry-auth-basic.cjs +5 -0
- package/dist/entry-auth-basic.d.cts +83 -0
- package/dist/entry-auth-basic.d.mts +83 -0
- package/dist/entry-auth-basic.mjs +2 -0
- package/dist/entry-auth-delegated.cjs +28 -0
- package/dist/entry-auth-delegated.cjs.map +1 -0
- package/dist/entry-auth-delegated.d.cts +36 -0
- package/dist/entry-auth-delegated.d.mts +36 -0
- package/dist/entry-auth-delegated.mjs +27 -0
- package/dist/entry-auth-delegated.mjs.map +1 -0
- package/dist/entry-auth-none.cjs +4 -0
- package/dist/entry-auth-none.d.cts +25 -0
- package/dist/entry-auth-none.d.mts +25 -0
- package/dist/entry-auth-none.mjs +2 -0
- package/dist/entry-authorization-delegated.cjs +28 -0
- package/dist/entry-authorization-delegated.cjs.map +1 -0
- package/dist/entry-authorization-delegated.d.cts +32 -0
- package/dist/entry-authorization-delegated.d.mts +32 -0
- package/dist/entry-authorization-delegated.mjs +27 -0
- package/dist/entry-authorization-delegated.mjs.map +1 -0
- package/dist/entry-authorization-none.cjs +3 -0
- package/dist/entry-authorization-none.d.cts +18 -0
- package/dist/entry-authorization-none.d.mts +18 -0
- package/dist/entry-authorization-none.mjs +2 -0
- package/dist/entry-authorization-roles.cjs +8 -0
- package/dist/entry-authorization-roles.d.cts +64 -0
- package/dist/entry-authorization-roles.d.mts +64 -0
- package/dist/entry-authorization-roles.mjs +3 -0
- package/dist/entry-bun.cjs +55 -0
- package/dist/entry-bun.cjs.map +1 -0
- package/dist/entry-bun.d.cts +29 -0
- package/dist/entry-bun.d.mts +29 -0
- package/dist/entry-bun.mjs +52 -0
- package/dist/entry-bun.mjs.map +1 -0
- package/dist/entry-drizzle-audit.cjs +191 -0
- package/dist/entry-drizzle-audit.cjs.map +1 -0
- package/dist/entry-drizzle-audit.d.cts +118 -0
- package/dist/entry-drizzle-audit.d.mts +118 -0
- package/dist/entry-drizzle-audit.mjs +186 -0
- package/dist/entry-drizzle-audit.mjs.map +1 -0
- package/dist/entry-drizzle-mysql.cjs +75 -0
- package/dist/entry-drizzle-mysql.cjs.map +1 -0
- package/dist/entry-drizzle-mysql.d.cts +42 -0
- package/dist/entry-drizzle-mysql.d.mts +42 -0
- package/dist/entry-drizzle-mysql.mjs +71 -0
- package/dist/entry-drizzle-mysql.mjs.map +1 -0
- package/dist/entry-drizzle-pg.cjs +82 -0
- package/dist/entry-drizzle-pg.cjs.map +1 -0
- package/dist/entry-drizzle-pg.d.cts +48 -0
- package/dist/entry-drizzle-pg.d.mts +48 -0
- package/dist/entry-drizzle-pg.mjs +78 -0
- package/dist/entry-drizzle-pg.mjs.map +1 -0
- package/dist/entry-drizzle-sqlite.cjs +71 -0
- package/dist/entry-drizzle-sqlite.cjs.map +1 -0
- package/dist/entry-drizzle-sqlite.d.cts +37 -0
- package/dist/entry-drizzle-sqlite.d.mts +37 -0
- package/dist/entry-drizzle-sqlite.mjs +67 -0
- package/dist/entry-drizzle-sqlite.mjs.map +1 -0
- package/dist/entry-elysia.cjs +112 -0
- package/dist/entry-elysia.cjs.map +1 -0
- package/dist/entry-elysia.d.cts +710 -0
- package/dist/entry-elysia.d.mts +710 -0
- package/dist/entry-elysia.mjs +109 -0
- package/dist/entry-elysia.mjs.map +1 -0
- package/dist/entry-elysia2.cjs +101 -0
- package/dist/entry-elysia2.cjs.map +1 -0
- package/dist/entry-elysia2.d.cts +905 -0
- package/dist/entry-elysia2.d.mts +905 -0
- package/dist/entry-elysia2.mjs +98 -0
- package/dist/entry-elysia2.mjs.map +1 -0
- package/dist/entry-express.cjs +90 -0
- package/dist/entry-express.cjs.map +1 -0
- package/dist/entry-express.d.cts +24 -0
- package/dist/entry-express.d.mts +24 -0
- package/dist/entry-express.mjs +88 -0
- package/dist/entry-express.mjs.map +1 -0
- package/dist/entry-hono.cjs +36 -0
- package/dist/entry-hono.cjs.map +1 -0
- package/dist/entry-hono.d.cts +24 -0
- package/dist/entry-hono.d.mts +24 -0
- package/dist/entry-hono.mjs +34 -0
- package/dist/entry-hono.mjs.map +1 -0
- package/dist/entry-hooks-log.cjs +22 -0
- package/dist/entry-hooks-log.cjs.map +1 -0
- package/dist/entry-hooks-log.d.cts +23 -0
- package/dist/entry-hooks-log.d.mts +23 -0
- package/dist/entry-hooks-log.mjs +21 -0
- package/dist/entry-hooks-log.mjs.map +1 -0
- package/dist/entry-sinks-console.cjs +43 -0
- package/dist/entry-sinks-console.cjs.map +1 -0
- package/dist/entry-sinks-console.d.cts +26 -0
- package/dist/entry-sinks-console.d.mts +26 -0
- package/dist/entry-sinks-console.mjs +41 -0
- package/dist/entry-sinks-console.mjs.map +1 -0
- package/dist/entry-sinks-datadog.cjs +97 -0
- package/dist/entry-sinks-datadog.cjs.map +1 -0
- package/dist/entry-sinks-datadog.d.cts +66 -0
- package/dist/entry-sinks-datadog.d.mts +66 -0
- package/dist/entry-sinks-datadog.mjs +91 -0
- package/dist/entry-sinks-datadog.mjs.map +1 -0
- package/dist/entry-sinks-file.cjs +100 -0
- package/dist/entry-sinks-file.cjs.map +1 -0
- package/dist/entry-sinks-file.d.cts +70 -0
- package/dist/entry-sinks-file.d.mts +70 -0
- package/dist/entry-sinks-file.mjs +97 -0
- package/dist/entry-sinks-file.mjs.map +1 -0
- package/dist/entry-sinks-http.cjs +63 -0
- package/dist/entry-sinks-http.cjs.map +1 -0
- package/dist/entry-sinks-http.d.cts +55 -0
- package/dist/entry-sinks-http.d.mts +55 -0
- package/dist/entry-sinks-http.mjs +60 -0
- package/dist/entry-sinks-http.mjs.map +1 -0
- package/dist/entry-sinks-s3.cjs +115 -0
- package/dist/entry-sinks-s3.cjs.map +1 -0
- package/dist/entry-sinks-s3.d.cts +79 -0
- package/dist/entry-sinks-s3.d.mts +79 -0
- package/dist/entry-sinks-s3.mjs +112 -0
- package/dist/entry-sinks-s3.mjs.map +1 -0
- package/dist/entry-sinks-splunk.cjs +80 -0
- package/dist/entry-sinks-splunk.cjs.map +1 -0
- package/dist/entry-sinks-splunk.d.cts +58 -0
- package/dist/entry-sinks-splunk.d.mts +58 -0
- package/dist/entry-sinks-splunk.mjs +77 -0
- package/dist/entry-sinks-splunk.mjs.map +1 -0
- package/dist/entry-sinks-webhook.cjs +130 -0
- package/dist/entry-sinks-webhook.cjs.map +1 -0
- package/dist/entry-sinks-webhook.d.cts +69 -0
- package/dist/entry-sinks-webhook.d.mts +69 -0
- package/dist/entry-sinks-webhook.mjs +125 -0
- package/dist/entry-sinks-webhook.mjs.map +1 -0
- package/dist/entry-sinks-xtandard-webhooks.cjs +64 -0
- package/dist/entry-sinks-xtandard-webhooks.cjs.map +1 -0
- package/dist/entry-sinks-xtandard-webhooks.d.cts +64 -0
- package/dist/entry-sinks-xtandard-webhooks.d.mts +64 -0
- package/dist/entry-sinks-xtandard-webhooks.mjs +63 -0
- package/dist/entry-sinks-xtandard-webhooks.mjs.map +1 -0
- package/dist/entry-storage-cloudflare-kv.cjs +47 -0
- package/dist/entry-storage-cloudflare-kv.cjs.map +1 -0
- package/dist/entry-storage-cloudflare-kv.d.cts +42 -0
- package/dist/entry-storage-cloudflare-kv.d.mts +42 -0
- package/dist/entry-storage-cloudflare-kv.mjs +46 -0
- package/dist/entry-storage-cloudflare-kv.mjs.map +1 -0
- package/dist/entry-storage-drizzle.cjs +228 -0
- package/dist/entry-storage-drizzle.cjs.map +1 -0
- package/dist/entry-storage-drizzle.d.cts +43 -0
- package/dist/entry-storage-drizzle.d.mts +43 -0
- package/dist/entry-storage-drizzle.mjs +227 -0
- package/dist/entry-storage-drizzle.mjs.map +1 -0
- package/dist/entry-storage-file.cjs +175 -0
- package/dist/entry-storage-file.cjs.map +1 -0
- package/dist/entry-storage-file.d.cts +41 -0
- package/dist/entry-storage-file.d.mts +41 -0
- package/dist/entry-storage-file.mjs +171 -0
- package/dist/entry-storage-file.mjs.map +1 -0
- package/dist/entry-storage-libsql.cjs +133 -0
- package/dist/entry-storage-libsql.cjs.map +1 -0
- package/dist/entry-storage-libsql.d.cts +60 -0
- package/dist/entry-storage-libsql.d.mts +60 -0
- package/dist/entry-storage-libsql.mjs +132 -0
- package/dist/entry-storage-libsql.mjs.map +1 -0
- package/dist/entry-storage-memory.cjs +3 -0
- package/dist/entry-storage-memory.d.cts +2 -0
- package/dist/entry-storage-memory.d.mts +2 -0
- package/dist/entry-storage-memory.mjs +2 -0
- package/dist/entry-storage-mongodb.cjs +306 -0
- package/dist/entry-storage-mongodb.cjs.map +1 -0
- package/dist/entry-storage-mongodb.d.cts +65 -0
- package/dist/entry-storage-mongodb.d.mts +65 -0
- package/dist/entry-storage-mongodb.mjs +304 -0
- package/dist/entry-storage-mongodb.mjs.map +1 -0
- package/dist/entry-storage-postgres.cjs +261 -0
- package/dist/entry-storage-postgres.cjs.map +1 -0
- package/dist/entry-storage-postgres.d.cts +66 -0
- package/dist/entry-storage-postgres.d.mts +66 -0
- package/dist/entry-storage-postgres.mjs +260 -0
- package/dist/entry-storage-postgres.mjs.map +1 -0
- package/dist/entry-storage-redis.cjs +223 -0
- package/dist/entry-storage-redis.cjs.map +1 -0
- package/dist/entry-storage-redis.d.cts +77 -0
- package/dist/entry-storage-redis.d.mts +77 -0
- package/dist/entry-storage-redis.mjs +221 -0
- package/dist/entry-storage-redis.mjs.map +1 -0
- package/dist/entry-storage-sqlite.cjs +85 -0
- package/dist/entry-storage-sqlite.cjs.map +1 -0
- package/dist/entry-storage-sqlite.d.cts +40 -0
- package/dist/entry-storage-sqlite.d.mts +40 -0
- package/dist/entry-storage-sqlite.mjs +84 -0
- package/dist/entry-storage-sqlite.mjs.map +1 -0
- package/dist/entry-storage-unstorage.cjs +57 -0
- package/dist/entry-storage-unstorage.cjs.map +1 -0
- package/dist/entry-storage-unstorage.d.cts +29 -0
- package/dist/entry-storage-unstorage.d.mts +29 -0
- package/dist/entry-storage-unstorage.mjs +56 -0
- package/dist/entry-storage-unstorage.mjs.map +1 -0
- package/dist/export-B9S-JeYl.mjs +239 -0
- package/dist/export-B9S-JeYl.mjs.map +1 -0
- package/dist/export-BZq0KCCn.d.mts +70 -0
- package/dist/export-DYfMd-ep.cjs +280 -0
- package/dist/export-DYfMd-ep.cjs.map +1 -0
- package/dist/export-Dh8T8I1p.d.cts +70 -0
- package/dist/index.cjs +279 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +286 -0
- package/dist/index.d.mts +284 -0
- package/dist/index.mjs +177 -0
- package/dist/index.mjs.map +1 -0
- package/dist/integrity-BHhjTBNk.cjs +614 -0
- package/dist/integrity-BHhjTBNk.cjs.map +1 -0
- package/dist/integrity-kfY2DNAi.mjs +483 -0
- package/dist/integrity-kfY2DNAi.mjs.map +1 -0
- package/dist/memory-CfykUo9W.cjs +155 -0
- package/dist/memory-CfykUo9W.cjs.map +1 -0
- package/dist/memory-DrR-Tlbf.d.mts +28 -0
- package/dist/memory-GG2Nba1D.mjs +150 -0
- package/dist/memory-GG2Nba1D.mjs.map +1 -0
- package/dist/memory-HpFdlMR_.d.cts +28 -0
- package/dist/none-Be7r6kHH.cjs +33 -0
- package/dist/none-Be7r6kHH.cjs.map +1 -0
- package/dist/none-CGmIIbI8.cjs +49 -0
- package/dist/none-CGmIIbI8.cjs.map +1 -0
- package/dist/none-CkV5mZsB.mjs +33 -0
- package/dist/none-CkV5mZsB.mjs.map +1 -0
- package/dist/none-DBeBeU0Z.mjs +23 -0
- package/dist/none-DBeBeU0Z.mjs.map +1 -0
- package/dist/query-ChGGtlA7.cjs +243 -0
- package/dist/query-ChGGtlA7.cjs.map +1 -0
- package/dist/query-LvZbyi37.mjs +172 -0
- package/dist/query-LvZbyi37.mjs.map +1 -0
- package/dist/react.css +1 -0
- package/dist/react.js +31936 -0
- package/dist/recorder-B3dG3jbd.d.mts +64 -0
- package/dist/recorder-CGY7HK29.d.cts +64 -0
- package/dist/roles-BARtYLSX.cjs +112 -0
- package/dist/roles-BARtYLSX.cjs.map +1 -0
- package/dist/roles-D7Pg89IJ.mjs +83 -0
- package/dist/roles-D7Pg89IJ.mjs.map +1 -0
- package/dist/schema-DmU7Wp0F.d.cts +251 -0
- package/dist/schema-DmU7Wp0F.d.mts +251 -0
- package/dist/schema.cjs +20 -0
- package/dist/schema.cjs.map +1 -0
- package/dist/schema.d.cts +2 -0
- package/dist/schema.d.mts +2 -0
- package/dist/schema.mjs +17 -0
- package/dist/schema.mjs.map +1 -0
- package/dist/shared-CJOyJKqT.d.mts +20 -0
- package/dist/shared-DSDY-V0n.mjs +100 -0
- package/dist/shared-DSDY-V0n.mjs.map +1 -0
- package/dist/shared-EANCdRqn.d.cts +20 -0
- package/dist/shared-OOAq-U4S.cjs +141 -0
- package/dist/shared-OOAq-U4S.cjs.map +1 -0
- package/dist/sql-B7b6HzGy.cjs +280 -0
- package/dist/sql-B7b6HzGy.cjs.map +1 -0
- package/dist/sql-COjPyn3F.mjs +209 -0
- package/dist/sql-COjPyn3F.mjs.map +1 -0
- package/dist/sqlite-event-log-BnoG8eos.cjs +184 -0
- package/dist/sqlite-event-log-BnoG8eos.cjs.map +1 -0
- package/dist/sqlite-event-log-nXmS2DS_.mjs +179 -0
- package/dist/sqlite-event-log-nXmS2DS_.mjs.map +1 -0
- package/dist/streams-CRuxOYcb.d.cts +124 -0
- package/dist/streams-DU0_gvI8.d.mts +124 -0
- package/dist/table-BcarDd10.d.cts +48 -0
- package/dist/table-BcarDd10.d.mts +48 -0
- package/dist/testing.cjs +189 -0
- package/dist/testing.cjs.map +1 -0
- package/dist/testing.d.cts +103 -0
- package/dist/testing.d.mts +103 -0
- package/dist/testing.mjs +185 -0
- package/dist/testing.mjs.map +1 -0
- package/dist/types-elysia2/adapters/bun.d.ts +47 -0
- package/dist/types-elysia2/adapters/context-shared.d.ts +40 -0
- package/dist/types-elysia2/adapters/elysia-shared.d.ts +36 -0
- package/dist/types-elysia2/adapters/elysia2.d.ts +588 -0
- package/dist/types-elysia2/auth/contract.d.ts +26 -0
- package/dist/types-elysia2/authorization/contract.d.ts +54 -0
- package/dist/types-elysia2/canonical.d.ts +25 -0
- package/dist/types-elysia2/context.d.ts +61 -0
- package/dist/types-elysia2/core.d.ts +232 -0
- package/dist/types-elysia2/duration.d.ts +26 -0
- package/dist/types-elysia2/entry-elysia2.d.ts +10 -0
- package/dist/types-elysia2/event-log.d.ts +33 -0
- package/dist/types-elysia2/export.d.ts +77 -0
- package/dist/types-elysia2/hooks/contract.d.ts +177 -0
- package/dist/types-elysia2/id.d.ts +27 -0
- package/dist/types-elysia2/integrity.d.ts +193 -0
- package/dist/types-elysia2/keys.d.ts +91 -0
- package/dist/types-elysia2/portal.d.ts +137 -0
- package/dist/types-elysia2/query.d.ts +88 -0
- package/dist/types-elysia2/schema.d.ts +247 -0
- package/dist/types-elysia2/server/base-path.d.ts +15 -0
- package/dist/types-elysia2/server/cors.d.ts +36 -0
- package/dist/types-elysia2/server/create-fetch-handler.d.ts +140 -0
- package/dist/types-elysia2/server/openapi.d.ts +25 -0
- package/dist/types-elysia2/server/render-index-html.d.ts +18 -0
- package/dist/types-elysia2/server/routes.d.ts +83 -0
- package/dist/types-elysia2/server/static-assets.d.ts +13 -0
- package/dist/types-elysia2/standard-schema.d.ts +100 -0
- package/dist/types-elysia2/storage/contract.d.ts +106 -0
- package/dist/types-elysia2/streams.d.ts +134 -0
- package/dist/types-elysia2/transforms.d.ts +56 -0
- package/dist/types-elysia2/validation.d.ts +48 -0
- package/dist/types-react/canonical.d.ts +25 -0
- package/dist/types-react/context.d.ts +61 -0
- package/dist/types-react/core.d.ts +232 -0
- package/dist/types-react/duration.d.ts +26 -0
- package/dist/types-react/event-log.d.ts +33 -0
- package/dist/types-react/hooks/contract.d.ts +177 -0
- package/dist/types-react/id.d.ts +27 -0
- package/dist/types-react/integrity.d.ts +193 -0
- package/dist/types-react/keys.d.ts +91 -0
- package/dist/types-react/query.d.ts +88 -0
- package/dist/types-react/react.d.ts +114 -0
- package/dist/types-react/schema.d.ts +247 -0
- package/dist/types-react/standard-schema.d.ts +100 -0
- package/dist/types-react/storage/contract.d.ts +106 -0
- package/dist/types-react/streams.d.ts +134 -0
- package/dist/types-react/transforms.d.ts +56 -0
- package/dist/types-react/ui/App.d.ts +36 -0
- package/dist/types-react/ui/api.d.ts +61 -0
- package/dist/types-react/ui/components/ActionFilter.d.ts +17 -0
- package/dist/types-react/ui/components/ExportMenu.d.ts +13 -0
- package/dist/types-react/ui/components/JsonCodeEditor.d.ts +12 -0
- package/dist/types-react/ui/components/ThemeToggle.d.ts +2 -0
- package/dist/types-react/ui/components/Toast.d.ts +16 -0
- package/dist/types-react/ui/components/audit-bits.d.ts +91 -0
- package/dist/types-react/ui/components/integrity-bits.d.ts +19 -0
- package/dist/types-react/ui/components/primitives.d.ts +50 -0
- package/dist/types-react/ui/components/ui-bits.d.ts +22 -0
- package/dist/types-react/ui/lib/filters.d.ts +70 -0
- package/dist/types-react/ui/lib/format.d.ts +82 -0
- package/dist/types-react/ui/lib/nav-guard.d.ts +20 -0
- package/dist/types-react/ui/lib/portal-container.d.ts +24 -0
- package/dist/types-react/ui/lib/utils.d.ts +3 -0
- package/dist/types-react/ui/theme.d.ts +40 -0
- package/dist/types-react/ui/types.d.ts +67 -0
- package/dist/types-react/ui/views/ActionsView.d.ts +10 -0
- package/dist/types-react/ui/views/EventDrawer.d.ts +15 -0
- package/dist/types-react/ui/views/EventsView.d.ts +10 -0
- package/dist/types-react/ui/views/IntegrityView.d.ts +10 -0
- package/dist/types-react/ui/views/OverviewView.d.ts +9 -0
- package/dist/types-react/ui/views/StreamsView.d.ts +10 -0
- package/dist/types-react/ui/views/TenantsView.d.ts +6 -0
- package/dist/types-react/validation.d.ts +48 -0
- package/dist/ui/assets/favicon-BSj8MPnj.svg +11 -0
- package/dist/ui/assets/index-B-qrQSOM.css +1 -0
- package/dist/ui/assets/index-CemlP5hR.js +244 -0
- package/dist/ui/index.html +15 -0
- package/dist/validation-DFrLESZD.mjs +150 -0
- package/dist/validation-DFrLESZD.mjs.map +1 -0
- package/dist/validation-lb0YXrxx.cjs +235 -0
- package/dist/validation-lb0YXrxx.cjs.map +1 -0
- package/dist/verify.cjs +14 -0
- package/dist/verify.d.cts +5 -0
- package/dist/verify.d.mts +5 -0
- package/dist/verify.mjs +3 -0
- package/package.json +610 -4
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { Column, Table } from "drizzle-orm";
|
|
2
|
+
|
|
3
|
+
//#region src/drizzle/table.d.ts
|
|
4
|
+
/** A table with the fixed `key`/`value` columns the audit KV store requires. */
|
|
5
|
+
type DrizzleKvTable = Table & {
|
|
6
|
+
key: Column;
|
|
7
|
+
value: Column;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* The native event-log table (`{name}_events`): one row per event, the full
|
|
11
|
+
* event in `data` plus the denormalized columns queries filter and sort on.
|
|
12
|
+
*/
|
|
13
|
+
type DrizzleEventsTable = Table & {
|
|
14
|
+
tenant: Column;
|
|
15
|
+
seq: Column;
|
|
16
|
+
id: Column;
|
|
17
|
+
action: Column;
|
|
18
|
+
occurredAt: Column;
|
|
19
|
+
recordedAt: Column;
|
|
20
|
+
actorId: Column;
|
|
21
|
+
actorType: Column;
|
|
22
|
+
outcome: Column;
|
|
23
|
+
search: Column;
|
|
24
|
+
data: Column;
|
|
25
|
+
};
|
|
26
|
+
/** The event-targets table (`{name}_event_targets`): one row per distinct event target. */
|
|
27
|
+
type DrizzleEventTargetsTable = Table & {
|
|
28
|
+
tenant: Column;
|
|
29
|
+
seq: Column;
|
|
30
|
+
type: Column;
|
|
31
|
+
targetId: Column;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* All three audit tables, as returned by `pgAuditTables()` / `mysqlAuditTables()` /
|
|
35
|
+
* `sqliteAuditTables()`. The keys match `createDrizzleStorage`'s options, so
|
|
36
|
+
* `createDrizzleStorage({ db, ...tables })` works.
|
|
37
|
+
*/
|
|
38
|
+
interface DrizzleAuditTables {
|
|
39
|
+
/** The KV table (control data: catalog, chain heads, checkpoints, cursors). */
|
|
40
|
+
table: DrizzleKvTable;
|
|
41
|
+
/** The events table. */
|
|
42
|
+
events: DrizzleEventsTable;
|
|
43
|
+
/** The event-targets table. */
|
|
44
|
+
eventTargets: DrizzleEventTargetsTable;
|
|
45
|
+
}
|
|
46
|
+
//#endregion
|
|
47
|
+
export { DrizzleKvTable as i, DrizzleEventTargetsTable as n, DrizzleEventsTable as r, DrizzleAuditTables as t };
|
|
48
|
+
//# sourceMappingURL=table-BcarDd10.d.cts.map
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { Column, Table } from "drizzle-orm";
|
|
2
|
+
|
|
3
|
+
//#region src/drizzle/table.d.ts
|
|
4
|
+
/** A table with the fixed `key`/`value` columns the audit KV store requires. */
|
|
5
|
+
type DrizzleKvTable = Table & {
|
|
6
|
+
key: Column;
|
|
7
|
+
value: Column;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* The native event-log table (`{name}_events`): one row per event, the full
|
|
11
|
+
* event in `data` plus the denormalized columns queries filter and sort on.
|
|
12
|
+
*/
|
|
13
|
+
type DrizzleEventsTable = Table & {
|
|
14
|
+
tenant: Column;
|
|
15
|
+
seq: Column;
|
|
16
|
+
id: Column;
|
|
17
|
+
action: Column;
|
|
18
|
+
occurredAt: Column;
|
|
19
|
+
recordedAt: Column;
|
|
20
|
+
actorId: Column;
|
|
21
|
+
actorType: Column;
|
|
22
|
+
outcome: Column;
|
|
23
|
+
search: Column;
|
|
24
|
+
data: Column;
|
|
25
|
+
};
|
|
26
|
+
/** The event-targets table (`{name}_event_targets`): one row per distinct event target. */
|
|
27
|
+
type DrizzleEventTargetsTable = Table & {
|
|
28
|
+
tenant: Column;
|
|
29
|
+
seq: Column;
|
|
30
|
+
type: Column;
|
|
31
|
+
targetId: Column;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* All three audit tables, as returned by `pgAuditTables()` / `mysqlAuditTables()` /
|
|
35
|
+
* `sqliteAuditTables()`. The keys match `createDrizzleStorage`'s options, so
|
|
36
|
+
* `createDrizzleStorage({ db, ...tables })` works.
|
|
37
|
+
*/
|
|
38
|
+
interface DrizzleAuditTables {
|
|
39
|
+
/** The KV table (control data: catalog, chain heads, checkpoints, cursors). */
|
|
40
|
+
table: DrizzleKvTable;
|
|
41
|
+
/** The events table. */
|
|
42
|
+
events: DrizzleEventsTable;
|
|
43
|
+
/** The event-targets table. */
|
|
44
|
+
eventTargets: DrizzleEventTargetsTable;
|
|
45
|
+
}
|
|
46
|
+
//#endregion
|
|
47
|
+
export { DrizzleKvTable as i, DrizzleEventTargetsTable as n, DrizzleEventsTable as r, DrizzleAuditTables as t };
|
|
48
|
+
//# sourceMappingURL=table-BcarDd10.d.mts.map
|
package/dist/testing.cjs
ADDED
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
const require_core = require("./core-CTr7dw0v.cjs");
|
|
3
|
+
const require_create_fetch_handler = require("./create-fetch-handler-D8cTMVX9.cjs");
|
|
4
|
+
const require_memory = require("./memory-CfykUo9W.cjs");
|
|
5
|
+
//#region src/testing.ts
|
|
6
|
+
/**
|
|
7
|
+
* Testing utilities: an in-memory core, a collecting sink and assertions, so a
|
|
8
|
+
* host app (or this package's own suite) can test its audit wiring without a
|
|
9
|
+
* database, timers or the network.
|
|
10
|
+
*
|
|
11
|
+
* - {@link createTestAudit}: an in-memory core, a {@link collectingSink}
|
|
12
|
+
* behind a **not-started** stream runner (drive it with `flush()`), an
|
|
13
|
+
* optional panel, and `events()` to read back everything recorded.
|
|
14
|
+
* - {@link collectingSink}: a sink that keeps every batch it receives — with
|
|
15
|
+
* programmable failures to exercise the stream retry path.
|
|
16
|
+
* - {@link expectRecorded} / {@link expectNotRecorded}: framework-agnostic
|
|
17
|
+
* assertions (they throw a descriptive `Error`) over what a core recorded.
|
|
18
|
+
*
|
|
19
|
+
* Import from `@xtandard/audit/testing`.
|
|
20
|
+
*
|
|
21
|
+
* @module testing
|
|
22
|
+
*/
|
|
23
|
+
/**
|
|
24
|
+
* Create a {@link CollectingSink}.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* ```ts
|
|
28
|
+
* const sink = collectingSink();
|
|
29
|
+
* const runner = createStreamRunner(audit, { streams: [{ name: "siem", sink, startFrom: "beginning" }] });
|
|
30
|
+
* await runner.tick();
|
|
31
|
+
* expect(sink.events().map((e) => e.action)).toEqual(["invoice.paid"]);
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
function collectingSink(kind = "collecting") {
|
|
35
|
+
const batches = [];
|
|
36
|
+
let failures = {
|
|
37
|
+
remaining: 0,
|
|
38
|
+
error: /* @__PURE__ */ new Error()
|
|
39
|
+
};
|
|
40
|
+
return {
|
|
41
|
+
kind,
|
|
42
|
+
batches,
|
|
43
|
+
async send(batch) {
|
|
44
|
+
if (failures.remaining > 0) {
|
|
45
|
+
failures.remaining--;
|
|
46
|
+
throw failures.error;
|
|
47
|
+
}
|
|
48
|
+
batches.push(structuredClone(batch));
|
|
49
|
+
},
|
|
50
|
+
events: () => batches.flatMap((b) => b.items.flatMap((i) => i.kind === "event" ? [i.event] : [])),
|
|
51
|
+
checkpoints: () => batches.flatMap((b) => b.items.flatMap((i) => i.kind === "checkpoint" ? [i.checkpoint] : [])),
|
|
52
|
+
failNext(n = 1, error = /* @__PURE__ */ new Error("collectingSink: simulated failure")) {
|
|
53
|
+
failures = {
|
|
54
|
+
remaining: n,
|
|
55
|
+
error
|
|
56
|
+
};
|
|
57
|
+
},
|
|
58
|
+
clear() {
|
|
59
|
+
batches.length = 0;
|
|
60
|
+
}
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* An in-memory audit core for tests, with a collecting sink streamed from the
|
|
65
|
+
* beginning of every tenant's log. No timers run: call `flush()` to stream.
|
|
66
|
+
*
|
|
67
|
+
* @example
|
|
68
|
+
* ```ts
|
|
69
|
+
* import { createTestAudit, expectRecorded } from "@xtandard/audit/testing";
|
|
70
|
+
*
|
|
71
|
+
* const { core, sink, flush } = createTestAudit();
|
|
72
|
+
* await core.record({ tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
73
|
+
* await expectRecorded(core, { tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
74
|
+
* await flush();
|
|
75
|
+
* sink.events(); // → [the invoice.paid event]
|
|
76
|
+
* ```
|
|
77
|
+
*/
|
|
78
|
+
function createTestAudit(options = {}) {
|
|
79
|
+
const storage = require_memory.createMemoryStorage();
|
|
80
|
+
const { panel: panelOptions, streams: extraStreams = [], ...coreOptions } = options;
|
|
81
|
+
const core = require_core.createAuditCore({
|
|
82
|
+
checkpoints: false,
|
|
83
|
+
...coreOptions,
|
|
84
|
+
storage
|
|
85
|
+
});
|
|
86
|
+
const sink = collectingSink();
|
|
87
|
+
const runner = require_create_fetch_handler.createStreamRunner(core, {
|
|
88
|
+
streams: [{
|
|
89
|
+
name: "test",
|
|
90
|
+
sink,
|
|
91
|
+
startFrom: "beginning"
|
|
92
|
+
}, ...extraStreams],
|
|
93
|
+
maxBackoff: 0
|
|
94
|
+
});
|
|
95
|
+
return {
|
|
96
|
+
core,
|
|
97
|
+
storage,
|
|
98
|
+
sink,
|
|
99
|
+
streams: runner,
|
|
100
|
+
panel: panelOptions ? require_create_fetch_handler.createFetchHandler({
|
|
101
|
+
...panelOptions === true ? {} : panelOptions,
|
|
102
|
+
core,
|
|
103
|
+
maintenance: false
|
|
104
|
+
}) : null,
|
|
105
|
+
flush: () => runner.tick(),
|
|
106
|
+
async events(tenant) {
|
|
107
|
+
const tenants = tenant ? [tenant] : (await core.listTenants()).map((t) => t.key);
|
|
108
|
+
const out = [];
|
|
109
|
+
for (const t of tenants) {
|
|
110
|
+
let after = 0;
|
|
111
|
+
for (;;) {
|
|
112
|
+
const page = await core.eventsBySeq(t, {
|
|
113
|
+
afterSeq: after,
|
|
114
|
+
limit: 500
|
|
115
|
+
});
|
|
116
|
+
if (page.length === 0) break;
|
|
117
|
+
out.push(...page);
|
|
118
|
+
after = page[page.length - 1].seq;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return out.sort((a, b) => a.recordedAt === b.recordedAt ? a.id < b.id ? -1 : 1 : a.recordedAt < b.recordedAt ? -1 : 1);
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
/** Deep subset: every key of `expected` matches in `actual` (arrays: every expected item matches some actual item). */
|
|
126
|
+
function subsetMatches(actual, expected) {
|
|
127
|
+
if (expected === void 0) return true;
|
|
128
|
+
if (expected === null || typeof expected !== "object") return Object.is(actual, expected);
|
|
129
|
+
if (Array.isArray(expected)) return Array.isArray(actual) && expected.every((e) => actual.some((a) => subsetMatches(a, e)));
|
|
130
|
+
if (actual === null || typeof actual !== "object" || Array.isArray(actual)) return false;
|
|
131
|
+
return Object.entries(expected).every(([k, v]) => subsetMatches(actual[k], v));
|
|
132
|
+
}
|
|
133
|
+
async function findRecorded(core, matcher) {
|
|
134
|
+
const seen = [];
|
|
135
|
+
let cursor;
|
|
136
|
+
for (;;) {
|
|
137
|
+
const page = await core.query({
|
|
138
|
+
...matcher.tenant ? { tenant: matcher.tenant } : {},
|
|
139
|
+
...matcher.action ? { actions: [matcher.action] } : {},
|
|
140
|
+
limit: 500,
|
|
141
|
+
...cursor ? { cursor } : {}
|
|
142
|
+
});
|
|
143
|
+
for (const event of page.items) {
|
|
144
|
+
if (subsetMatches(event, matcher)) return {
|
|
145
|
+
match: event,
|
|
146
|
+
seen
|
|
147
|
+
};
|
|
148
|
+
seen.push(event);
|
|
149
|
+
}
|
|
150
|
+
if (!page.pageInfo.hasNextPage || !page.pageInfo.endCursor) return {
|
|
151
|
+
match: null,
|
|
152
|
+
seen
|
|
153
|
+
};
|
|
154
|
+
cursor = page.pageInfo.endCursor;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Assert that `core` recorded an event matching `matcher` (deep subset).
|
|
159
|
+
* Resolves to the newest matching event; throws a descriptive `Error`
|
|
160
|
+
* (listing what was recorded instead) otherwise. Works with any test runner.
|
|
161
|
+
*
|
|
162
|
+
* @example
|
|
163
|
+
* ```ts
|
|
164
|
+
* const event = await expectRecorded(core, {
|
|
165
|
+
* tenant: "acme",
|
|
166
|
+
* action: "member.role_changed",
|
|
167
|
+
* targets: [{ type: "user", id: "u2" }],
|
|
168
|
+
* metadata: { to: "admin" },
|
|
169
|
+
* });
|
|
170
|
+
* ```
|
|
171
|
+
*/
|
|
172
|
+
async function expectRecorded(core, matcher) {
|
|
173
|
+
const { match, seen } = await findRecorded(core, matcher);
|
|
174
|
+
if (match) return match;
|
|
175
|
+
const summary = seen.slice(0, 10).map((e) => ` - [${e.tenant}#${e.seq}] ${e.action} by ${e.actor.id}`).join("\n");
|
|
176
|
+
throw new Error(`Expected an audit event matching ${JSON.stringify(matcher)}, but none was recorded.` + (seen.length ? `\nCandidates (${seen.length}):\n${summary}${seen.length > 10 ? "\n …" : ""}` : "\nNo candidate events (same tenant/action) were recorded."));
|
|
177
|
+
}
|
|
178
|
+
/** Assert that `core` recorded **no** event matching `matcher`. */
|
|
179
|
+
async function expectNotRecorded(core, matcher) {
|
|
180
|
+
const { match } = await findRecorded(core, matcher);
|
|
181
|
+
if (match) throw new Error(`Expected no audit event matching ${JSON.stringify(matcher)}, but found ${match.id} ([${match.tenant}#${match.seq}] ${match.action}).`);
|
|
182
|
+
}
|
|
183
|
+
//#endregion
|
|
184
|
+
exports.collectingSink = collectingSink;
|
|
185
|
+
exports.createTestAudit = createTestAudit;
|
|
186
|
+
exports.expectNotRecorded = expectNotRecorded;
|
|
187
|
+
exports.expectRecorded = expectRecorded;
|
|
188
|
+
|
|
189
|
+
//# sourceMappingURL=testing.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.cjs","names":["createMemoryStorage","createAuditCore","createStreamRunner","createFetchHandler"],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * Testing utilities: an in-memory core, a collecting sink and assertions, so a\n * host app (or this package's own suite) can test its audit wiring without a\n * database, timers or the network.\n *\n * - {@link createTestAudit}: an in-memory core, a {@link collectingSink}\n * behind a **not-started** stream runner (drive it with `flush()`), an\n * optional panel, and `events()` to read back everything recorded.\n * - {@link collectingSink}: a sink that keeps every batch it receives — with\n * programmable failures to exercise the stream retry path.\n * - {@link expectRecorded} / {@link expectNotRecorded}: framework-agnostic\n * assertions (they throw a descriptive `Error`) over what a core recorded.\n *\n * Import from `@xtandard/audit/testing`.\n *\n * @module testing\n */\n\nimport { createAuditCore, type AuditCore, type AuditCoreOptions } from \"./core.ts\";\nimport type {\n AuditActor,\n AuditContext,\n AuditEvent,\n AuditOutcome,\n AuditTarget,\n JsonObject,\n} from \"./schema.ts\";\nimport {\n createFetchHandler,\n type AuditPanelOptions,\n type CreateFetchHandlerResult,\n} from \"./server/create-fetch-handler.ts\";\nimport type { ActionMap } from \"./standard-schema.ts\";\nimport { createMemoryStorage, type MemoryAuditStorage } from \"./storage/memory.ts\";\nimport {\n createStreamRunner,\n type AuditSink,\n type StreamBatch,\n type StreamDefinition,\n type StreamRunner,\n} from \"./streams.ts\";\nimport type { AuditCheckpoint } from \"./schema.ts\";\n\n/** A sink that records every batch it is sent. */\nexport interface CollectingSink extends AuditSink {\n /** Every batch accepted, in order. */\n readonly batches: StreamBatch[];\n /** Every event item accepted, in order. */\n events(): AuditEvent[];\n /** Every checkpoint item accepted, in order. */\n checkpoints(): AuditCheckpoint[];\n /** Reject the next `n` sends (default 1) with `error` (default a generic `Error`). */\n failNext(n?: number, error?: Error): void;\n /** Forget everything collected. */\n clear(): void;\n}\n\n/**\n * Create a {@link CollectingSink}.\n *\n * @example\n * ```ts\n * const sink = collectingSink();\n * const runner = createStreamRunner(audit, { streams: [{ name: \"siem\", sink, startFrom: \"beginning\" }] });\n * await runner.tick();\n * expect(sink.events().map((e) => e.action)).toEqual([\"invoice.paid\"]);\n * ```\n */\nexport function collectingSink(kind = \"collecting\"): CollectingSink {\n const batches: StreamBatch[] = [];\n let failures: { remaining: number; error: Error } = { remaining: 0, error: new Error() };\n return {\n kind,\n batches,\n async send(batch) {\n if (failures.remaining > 0) {\n failures.remaining--;\n throw failures.error;\n }\n batches.push(structuredClone(batch));\n },\n events: () =>\n batches.flatMap((b) => b.items.flatMap((i) => (i.kind === \"event\" ? [i.event] : []))),\n checkpoints: () =>\n batches.flatMap((b) =>\n b.items.flatMap((i) => (i.kind === \"checkpoint\" ? [i.checkpoint] : [])),\n ),\n failNext(n = 1, error = new Error(\"collectingSink: simulated failure\")) {\n failures = { remaining: n, error };\n },\n clear() {\n batches.length = 0;\n },\n };\n}\n\n/** Options for {@link createTestAudit}. */\nexport interface TestAuditOptions<A extends ActionMap = ActionMap> extends Omit<\n AuditCoreOptions<A>,\n \"storage\"\n> {\n /** Also build a panel over the same core (`true` for defaults). Its stream runner is not started. */\n panel?: Omit<AuditPanelOptions, \"storage\" | \"core\" | \"streams\" | \"streamRunner\"> | boolean;\n /** Extra streams beside the built-in `\"test\"` stream feeding {@link TestAudit.sink}. */\n streams?: StreamDefinition[];\n}\n\n/** Result of {@link createTestAudit}. */\nexport interface TestAudit<A extends ActionMap = ActionMap> {\n core: AuditCore<A>;\n storage: MemoryAuditStorage;\n /** Receives every event (and checkpoint) of every tenant once you `flush()`. */\n sink: CollectingSink;\n /** The NOT started runner behind `sink` — `flush()` ticks it. */\n streams: StreamRunner;\n /** The panel, when `panel` was requested. */\n panel: CreateFetchHandlerResult | null;\n /** Run one stream pass (delivers everything recorded so far to `sink`). */\n flush(): Promise<void>;\n /** Every stored event (all tenants, or one), oldest first. */\n events(tenant?: string): Promise<AuditEvent[]>;\n}\n\n/**\n * An in-memory audit core for tests, with a collecting sink streamed from the\n * beginning of every tenant's log. No timers run: call `flush()` to stream.\n *\n * @example\n * ```ts\n * import { createTestAudit, expectRecorded } from \"@xtandard/audit/testing\";\n *\n * const { core, sink, flush } = createTestAudit();\n * await core.record({ tenant: \"acme\", action: \"invoice.paid\", actor: { id: \"u1\" } });\n * await expectRecorded(core, { tenant: \"acme\", action: \"invoice.paid\", actor: { id: \"u1\" } });\n * await flush();\n * sink.events(); // → [the invoice.paid event]\n * ```\n */\nexport function createTestAudit<const A extends ActionMap = ActionMap>(\n options: TestAuditOptions<A> = {},\n): TestAudit<A> {\n const storage = createMemoryStorage();\n const { panel: panelOptions, streams: extraStreams = [], ...coreOptions } = options;\n const core = createAuditCore<A>({ checkpoints: false, ...coreOptions, storage });\n const sink = collectingSink();\n const definitions: StreamDefinition[] = [\n { name: \"test\", sink, startFrom: \"beginning\" },\n ...extraStreams,\n ];\n const runner = createStreamRunner(core, { streams: definitions, maxBackoff: 0 });\n const panel = panelOptions\n ? createFetchHandler({\n ...(panelOptions === true ? {} : panelOptions),\n core: core as unknown as AuditCore<ActionMap>,\n maintenance: false,\n })\n : null;\n\n return {\n core,\n storage,\n sink,\n streams: runner,\n panel,\n flush: () => runner.tick(),\n async events(tenant) {\n const tenants = tenant ? [tenant] : (await core.listTenants()).map((t) => t.key);\n const out: AuditEvent[] = [];\n for (const t of tenants) {\n let after = 0;\n for (;;) {\n const page = await core.eventsBySeq(t, { afterSeq: after, limit: 500 });\n if (page.length === 0) break;\n out.push(...page);\n after = page[page.length - 1]!.seq;\n }\n }\n return out.sort((a, b) =>\n a.recordedAt === b.recordedAt\n ? a.id < b.id\n ? -1\n : 1\n : a.recordedAt < b.recordedAt\n ? -1\n : 1,\n );\n },\n };\n}\n\n/** What {@link expectRecorded} matches: every given field must match (deep subset). */\nexport interface RecordedMatcher {\n tenant?: string;\n action?: string;\n actor?: Partial<AuditActor>;\n /** Each listed target must be present (subset match on its fields). */\n targets?: Partial<AuditTarget>[];\n context?: Partial<AuditContext>;\n metadata?: JsonObject;\n outcome?: AuditOutcome;\n description?: string;\n}\n\n/** Deep subset: every key of `expected` matches in `actual` (arrays: every expected item matches some actual item). */\nfunction subsetMatches(actual: unknown, expected: unknown): boolean {\n if (expected === undefined) return true;\n if (expected === null || typeof expected !== \"object\") return Object.is(actual, expected);\n if (Array.isArray(expected)) {\n return Array.isArray(actual) && expected.every((e) => actual.some((a) => subsetMatches(a, e)));\n }\n if (actual === null || typeof actual !== \"object\" || Array.isArray(actual)) return false;\n return Object.entries(expected).every(([k, v]) =>\n subsetMatches((actual as Record<string, unknown>)[k], v),\n );\n}\n\nasync function findRecorded<A extends ActionMap>(\n core: AuditCore<A>,\n matcher: RecordedMatcher,\n): Promise<{ match: AuditEvent | null; seen: AuditEvent[] }> {\n const seen: AuditEvent[] = [];\n let cursor: string | undefined;\n for (;;) {\n const page = await core.query({\n ...(matcher.tenant ? { tenant: matcher.tenant } : {}),\n ...(matcher.action ? { actions: [matcher.action] } : {}),\n limit: 500,\n ...(cursor ? { cursor } : {}),\n });\n for (const event of page.items) {\n if (subsetMatches(event, matcher)) return { match: event, seen };\n seen.push(event);\n }\n if (!page.pageInfo.hasNextPage || !page.pageInfo.endCursor) return { match: null, seen };\n cursor = page.pageInfo.endCursor;\n }\n}\n\n/**\n * Assert that `core` recorded an event matching `matcher` (deep subset).\n * Resolves to the newest matching event; throws a descriptive `Error`\n * (listing what was recorded instead) otherwise. Works with any test runner.\n *\n * @example\n * ```ts\n * const event = await expectRecorded(core, {\n * tenant: \"acme\",\n * action: \"member.role_changed\",\n * targets: [{ type: \"user\", id: \"u2\" }],\n * metadata: { to: \"admin\" },\n * });\n * ```\n */\nexport async function expectRecorded<A extends ActionMap>(\n core: AuditCore<A>,\n matcher: RecordedMatcher,\n): Promise<AuditEvent> {\n const { match, seen } = await findRecorded(core, matcher);\n if (match) return match;\n const summary = seen\n .slice(0, 10)\n .map((e) => ` - [${e.tenant}#${e.seq}] ${e.action} by ${e.actor.id}`)\n .join(\"\\n\");\n throw new Error(\n `Expected an audit event matching ${JSON.stringify(matcher)}, but none was recorded.` +\n (seen.length\n ? `\\nCandidates (${seen.length}):\\n${summary}${seen.length > 10 ? \"\\n …\" : \"\"}`\n : \"\\nNo candidate events (same tenant/action) were recorded.\"),\n );\n}\n\n/** Assert that `core` recorded **no** event matching `matcher`. */\nexport async function expectNotRecorded<A extends ActionMap>(\n core: AuditCore<A>,\n matcher: RecordedMatcher,\n): Promise<void> {\n const { match } = await findRecorded(core, matcher);\n if (match) {\n throw new Error(\n `Expected no audit event matching ${JSON.stringify(matcher)}, but found ${match.id} ` +\n `([${match.tenant}#${match.seq}] ${match.action}).`,\n );\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { a as AuditContext, i as AuditCheckpoint, m as AuditTarget, r as AuditActor, s as AuditEvent, u as AuditOutcome, v as JsonObject } from "./schema-DmU7Wp0F.cjs";
|
|
2
|
+
import { E as ActionMap, n as AuditCore, r as AuditCoreOptions } from "./core-C0ceVOTk.cjs";
|
|
3
|
+
import { i as StreamDefinition, n as StreamBatch, o as StreamRunner, t as AuditSink } from "./streams-CRuxOYcb.cjs";
|
|
4
|
+
import { n as CreateFetchHandlerResult, t as AuditPanelOptions } from "./create-fetch-handler-1pXSEhGi.cjs";
|
|
5
|
+
import { t as MemoryAuditStorage } from "./memory-HpFdlMR_.cjs";
|
|
6
|
+
|
|
7
|
+
//#region src/testing.d.ts
|
|
8
|
+
/** A sink that records every batch it is sent. */
|
|
9
|
+
interface CollectingSink extends AuditSink {
|
|
10
|
+
/** Every batch accepted, in order. */
|
|
11
|
+
readonly batches: StreamBatch[];
|
|
12
|
+
/** Every event item accepted, in order. */
|
|
13
|
+
events(): AuditEvent[];
|
|
14
|
+
/** Every checkpoint item accepted, in order. */
|
|
15
|
+
checkpoints(): AuditCheckpoint[];
|
|
16
|
+
/** Reject the next `n` sends (default 1) with `error` (default a generic `Error`). */
|
|
17
|
+
failNext(n?: number, error?: Error): void;
|
|
18
|
+
/** Forget everything collected. */
|
|
19
|
+
clear(): void;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Create a {@link CollectingSink}.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```ts
|
|
26
|
+
* const sink = collectingSink();
|
|
27
|
+
* const runner = createStreamRunner(audit, { streams: [{ name: "siem", sink, startFrom: "beginning" }] });
|
|
28
|
+
* await runner.tick();
|
|
29
|
+
* expect(sink.events().map((e) => e.action)).toEqual(["invoice.paid"]);
|
|
30
|
+
* ```
|
|
31
|
+
*/
|
|
32
|
+
declare function collectingSink(kind?: string): CollectingSink;
|
|
33
|
+
/** Options for {@link createTestAudit}. */
|
|
34
|
+
interface TestAuditOptions<A extends ActionMap = ActionMap> extends Omit<AuditCoreOptions<A>, "storage"> {
|
|
35
|
+
/** Also build a panel over the same core (`true` for defaults). Its stream runner is not started. */
|
|
36
|
+
panel?: Omit<AuditPanelOptions, "storage" | "core" | "streams" | "streamRunner"> | boolean;
|
|
37
|
+
/** Extra streams beside the built-in `"test"` stream feeding {@link TestAudit.sink}. */
|
|
38
|
+
streams?: StreamDefinition[];
|
|
39
|
+
}
|
|
40
|
+
/** Result of {@link createTestAudit}. */
|
|
41
|
+
interface TestAudit<A extends ActionMap = ActionMap> {
|
|
42
|
+
core: AuditCore<A>;
|
|
43
|
+
storage: MemoryAuditStorage;
|
|
44
|
+
/** Receives every event (and checkpoint) of every tenant once you `flush()`. */
|
|
45
|
+
sink: CollectingSink;
|
|
46
|
+
/** The NOT started runner behind `sink` — `flush()` ticks it. */
|
|
47
|
+
streams: StreamRunner;
|
|
48
|
+
/** The panel, when `panel` was requested. */
|
|
49
|
+
panel: CreateFetchHandlerResult | null;
|
|
50
|
+
/** Run one stream pass (delivers everything recorded so far to `sink`). */
|
|
51
|
+
flush(): Promise<void>;
|
|
52
|
+
/** Every stored event (all tenants, or one), oldest first. */
|
|
53
|
+
events(tenant?: string): Promise<AuditEvent[]>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* An in-memory audit core for tests, with a collecting sink streamed from the
|
|
57
|
+
* beginning of every tenant's log. No timers run: call `flush()` to stream.
|
|
58
|
+
*
|
|
59
|
+
* @example
|
|
60
|
+
* ```ts
|
|
61
|
+
* import { createTestAudit, expectRecorded } from "@xtandard/audit/testing";
|
|
62
|
+
*
|
|
63
|
+
* const { core, sink, flush } = createTestAudit();
|
|
64
|
+
* await core.record({ tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
65
|
+
* await expectRecorded(core, { tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
66
|
+
* await flush();
|
|
67
|
+
* sink.events(); // → [the invoice.paid event]
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
declare function createTestAudit<const A extends ActionMap = ActionMap>(options?: TestAuditOptions<A>): TestAudit<A>;
|
|
71
|
+
/** What {@link expectRecorded} matches: every given field must match (deep subset). */
|
|
72
|
+
interface RecordedMatcher {
|
|
73
|
+
tenant?: string;
|
|
74
|
+
action?: string;
|
|
75
|
+
actor?: Partial<AuditActor>;
|
|
76
|
+
/** Each listed target must be present (subset match on its fields). */
|
|
77
|
+
targets?: Partial<AuditTarget>[];
|
|
78
|
+
context?: Partial<AuditContext>;
|
|
79
|
+
metadata?: JsonObject;
|
|
80
|
+
outcome?: AuditOutcome;
|
|
81
|
+
description?: string;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Assert that `core` recorded an event matching `matcher` (deep subset).
|
|
85
|
+
* Resolves to the newest matching event; throws a descriptive `Error`
|
|
86
|
+
* (listing what was recorded instead) otherwise. Works with any test runner.
|
|
87
|
+
*
|
|
88
|
+
* @example
|
|
89
|
+
* ```ts
|
|
90
|
+
* const event = await expectRecorded(core, {
|
|
91
|
+
* tenant: "acme",
|
|
92
|
+
* action: "member.role_changed",
|
|
93
|
+
* targets: [{ type: "user", id: "u2" }],
|
|
94
|
+
* metadata: { to: "admin" },
|
|
95
|
+
* });
|
|
96
|
+
* ```
|
|
97
|
+
*/
|
|
98
|
+
declare function expectRecorded<A extends ActionMap>(core: AuditCore<A>, matcher: RecordedMatcher): Promise<AuditEvent>;
|
|
99
|
+
/** Assert that `core` recorded **no** event matching `matcher`. */
|
|
100
|
+
declare function expectNotRecorded<A extends ActionMap>(core: AuditCore<A>, matcher: RecordedMatcher): Promise<void>;
|
|
101
|
+
//#endregion
|
|
102
|
+
export { CollectingSink, RecordedMatcher, TestAudit, TestAuditOptions, collectingSink, createTestAudit, expectNotRecorded, expectRecorded };
|
|
103
|
+
//# sourceMappingURL=testing.d.cts.map
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { a as AuditContext, i as AuditCheckpoint, m as AuditTarget, r as AuditActor, s as AuditEvent, u as AuditOutcome, v as JsonObject } from "./schema-DmU7Wp0F.mjs";
|
|
2
|
+
import { E as ActionMap, n as AuditCore, r as AuditCoreOptions } from "./core-KtEHRScZ.mjs";
|
|
3
|
+
import { i as StreamDefinition, n as StreamBatch, o as StreamRunner, t as AuditSink } from "./streams-DU0_gvI8.mjs";
|
|
4
|
+
import { n as CreateFetchHandlerResult, t as AuditPanelOptions } from "./create-fetch-handler-zioPVS18.mjs";
|
|
5
|
+
import { t as MemoryAuditStorage } from "./memory-DrR-Tlbf.mjs";
|
|
6
|
+
|
|
7
|
+
//#region src/testing.d.ts
|
|
8
|
+
/** A sink that records every batch it is sent. */
|
|
9
|
+
interface CollectingSink extends AuditSink {
|
|
10
|
+
/** Every batch accepted, in order. */
|
|
11
|
+
readonly batches: StreamBatch[];
|
|
12
|
+
/** Every event item accepted, in order. */
|
|
13
|
+
events(): AuditEvent[];
|
|
14
|
+
/** Every checkpoint item accepted, in order. */
|
|
15
|
+
checkpoints(): AuditCheckpoint[];
|
|
16
|
+
/** Reject the next `n` sends (default 1) with `error` (default a generic `Error`). */
|
|
17
|
+
failNext(n?: number, error?: Error): void;
|
|
18
|
+
/** Forget everything collected. */
|
|
19
|
+
clear(): void;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Create a {@link CollectingSink}.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```ts
|
|
26
|
+
* const sink = collectingSink();
|
|
27
|
+
* const runner = createStreamRunner(audit, { streams: [{ name: "siem", sink, startFrom: "beginning" }] });
|
|
28
|
+
* await runner.tick();
|
|
29
|
+
* expect(sink.events().map((e) => e.action)).toEqual(["invoice.paid"]);
|
|
30
|
+
* ```
|
|
31
|
+
*/
|
|
32
|
+
declare function collectingSink(kind?: string): CollectingSink;
|
|
33
|
+
/** Options for {@link createTestAudit}. */
|
|
34
|
+
interface TestAuditOptions<A extends ActionMap = ActionMap> extends Omit<AuditCoreOptions<A>, "storage"> {
|
|
35
|
+
/** Also build a panel over the same core (`true` for defaults). Its stream runner is not started. */
|
|
36
|
+
panel?: Omit<AuditPanelOptions, "storage" | "core" | "streams" | "streamRunner"> | boolean;
|
|
37
|
+
/** Extra streams beside the built-in `"test"` stream feeding {@link TestAudit.sink}. */
|
|
38
|
+
streams?: StreamDefinition[];
|
|
39
|
+
}
|
|
40
|
+
/** Result of {@link createTestAudit}. */
|
|
41
|
+
interface TestAudit<A extends ActionMap = ActionMap> {
|
|
42
|
+
core: AuditCore<A>;
|
|
43
|
+
storage: MemoryAuditStorage;
|
|
44
|
+
/** Receives every event (and checkpoint) of every tenant once you `flush()`. */
|
|
45
|
+
sink: CollectingSink;
|
|
46
|
+
/** The NOT started runner behind `sink` — `flush()` ticks it. */
|
|
47
|
+
streams: StreamRunner;
|
|
48
|
+
/** The panel, when `panel` was requested. */
|
|
49
|
+
panel: CreateFetchHandlerResult | null;
|
|
50
|
+
/** Run one stream pass (delivers everything recorded so far to `sink`). */
|
|
51
|
+
flush(): Promise<void>;
|
|
52
|
+
/** Every stored event (all tenants, or one), oldest first. */
|
|
53
|
+
events(tenant?: string): Promise<AuditEvent[]>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* An in-memory audit core for tests, with a collecting sink streamed from the
|
|
57
|
+
* beginning of every tenant's log. No timers run: call `flush()` to stream.
|
|
58
|
+
*
|
|
59
|
+
* @example
|
|
60
|
+
* ```ts
|
|
61
|
+
* import { createTestAudit, expectRecorded } from "@xtandard/audit/testing";
|
|
62
|
+
*
|
|
63
|
+
* const { core, sink, flush } = createTestAudit();
|
|
64
|
+
* await core.record({ tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
65
|
+
* await expectRecorded(core, { tenant: "acme", action: "invoice.paid", actor: { id: "u1" } });
|
|
66
|
+
* await flush();
|
|
67
|
+
* sink.events(); // → [the invoice.paid event]
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
declare function createTestAudit<const A extends ActionMap = ActionMap>(options?: TestAuditOptions<A>): TestAudit<A>;
|
|
71
|
+
/** What {@link expectRecorded} matches: every given field must match (deep subset). */
|
|
72
|
+
interface RecordedMatcher {
|
|
73
|
+
tenant?: string;
|
|
74
|
+
action?: string;
|
|
75
|
+
actor?: Partial<AuditActor>;
|
|
76
|
+
/** Each listed target must be present (subset match on its fields). */
|
|
77
|
+
targets?: Partial<AuditTarget>[];
|
|
78
|
+
context?: Partial<AuditContext>;
|
|
79
|
+
metadata?: JsonObject;
|
|
80
|
+
outcome?: AuditOutcome;
|
|
81
|
+
description?: string;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Assert that `core` recorded an event matching `matcher` (deep subset).
|
|
85
|
+
* Resolves to the newest matching event; throws a descriptive `Error`
|
|
86
|
+
* (listing what was recorded instead) otherwise. Works with any test runner.
|
|
87
|
+
*
|
|
88
|
+
* @example
|
|
89
|
+
* ```ts
|
|
90
|
+
* const event = await expectRecorded(core, {
|
|
91
|
+
* tenant: "acme",
|
|
92
|
+
* action: "member.role_changed",
|
|
93
|
+
* targets: [{ type: "user", id: "u2" }],
|
|
94
|
+
* metadata: { to: "admin" },
|
|
95
|
+
* });
|
|
96
|
+
* ```
|
|
97
|
+
*/
|
|
98
|
+
declare function expectRecorded<A extends ActionMap>(core: AuditCore<A>, matcher: RecordedMatcher): Promise<AuditEvent>;
|
|
99
|
+
/** Assert that `core` recorded **no** event matching `matcher`. */
|
|
100
|
+
declare function expectNotRecorded<A extends ActionMap>(core: AuditCore<A>, matcher: RecordedMatcher): Promise<void>;
|
|
101
|
+
//#endregion
|
|
102
|
+
export { CollectingSink, RecordedMatcher, TestAudit, TestAuditOptions, collectingSink, createTestAudit, expectNotRecorded, expectRecorded };
|
|
103
|
+
//# sourceMappingURL=testing.d.mts.map
|