@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,306 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
const require_query = require("./query-ChGGtlA7.cjs");
|
|
3
|
+
const require_contract = require("./contract-DYvBNdnR.cjs");
|
|
4
|
+
//#region src/storage/mongodb.ts
|
|
5
|
+
/** Read projection: hand back exactly the stored event. */
|
|
6
|
+
const EVENT_PROJECTION = {
|
|
7
|
+
_id: 0,
|
|
8
|
+
search: 0
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* Escape characters that are special in a regular expression so a literal
|
|
12
|
+
* string can be embedded into a pattern.
|
|
13
|
+
*/
|
|
14
|
+
function escapeRegex(input) {
|
|
15
|
+
return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
16
|
+
}
|
|
17
|
+
/** Anchored "starts with" regex for a literal prefix. */
|
|
18
|
+
const startsWith = (prefix) => new RegExp(`^${escapeRegex(prefix)}`);
|
|
19
|
+
const toDoc = (event) => ({
|
|
20
|
+
...event,
|
|
21
|
+
search: require_query.searchText(event)
|
|
22
|
+
});
|
|
23
|
+
/** Is this a duplicate-key (E11000) error, top-level or inside a bulk write? */
|
|
24
|
+
function isDuplicateKey(error) {
|
|
25
|
+
const e = error;
|
|
26
|
+
if (e?.code === 11e3) return true;
|
|
27
|
+
return Array.isArray(e?.writeErrors) && e.writeErrors.some((w) => w.code === 11e3);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Compile a {@link NormalizedQuery} to a Mongo filter that agrees exactly with
|
|
31
|
+
* `matchesQuery` (plus the keyset position when the query has one).
|
|
32
|
+
*/
|
|
33
|
+
function mongoEventFilter(q) {
|
|
34
|
+
const and = [];
|
|
35
|
+
if (q.tenant !== void 0) and.push({ tenant: q.tenant });
|
|
36
|
+
if ((q.actions.length > 0 || q.actionPrefixes.length > 0) && !q.actionPrefixes.includes("")) {
|
|
37
|
+
const include = [];
|
|
38
|
+
if (q.actions.length > 0) include.push({ action: { $in: q.actions } });
|
|
39
|
+
for (const p of q.actionPrefixes) include.push({ action: { $regex: startsWith(p) } });
|
|
40
|
+
and.push(include.length === 1 ? include[0] : { $or: include });
|
|
41
|
+
}
|
|
42
|
+
if (q.excludeActions.length > 0) and.push({ action: { $nin: q.excludeActions } });
|
|
43
|
+
for (const p of q.excludeActionPrefixes) and.push({ action: { $not: startsWith(p) } });
|
|
44
|
+
if (q.actorId !== void 0) and.push({ "actor.id": q.actorId });
|
|
45
|
+
if (q.actorType !== void 0) and.push({ "actor.type": q.actorType === "user" ? { $in: ["user", null] } : q.actorType });
|
|
46
|
+
if (q.targetType !== void 0 || q.targetId !== void 0) and.push({ targets: { $elemMatch: {
|
|
47
|
+
...q.targetType !== void 0 ? { type: q.targetType } : {},
|
|
48
|
+
...q.targetId !== void 0 ? { id: q.targetId } : {}
|
|
49
|
+
} } });
|
|
50
|
+
if (q.outcome !== void 0) and.push({ outcome: q.outcome });
|
|
51
|
+
if (q.from !== void 0 || q.to !== void 0) and.push({ occurredAt: {
|
|
52
|
+
...q.from !== void 0 ? { $gte: q.from } : {},
|
|
53
|
+
...q.to !== void 0 ? { $lt: q.to } : {}
|
|
54
|
+
} });
|
|
55
|
+
if (q.search !== void 0) and.push({ search: { $regex: new RegExp(escapeRegex(q.search)) } });
|
|
56
|
+
if (q.after) {
|
|
57
|
+
const op = q.order === "desc" ? "$lt" : "$gt";
|
|
58
|
+
and.push({ $or: [{ occurredAt: { [op]: q.after.occurredAt } }, {
|
|
59
|
+
occurredAt: q.after.occurredAt,
|
|
60
|
+
id: { [op]: q.after.id }
|
|
61
|
+
}] });
|
|
62
|
+
}
|
|
63
|
+
return and.length === 0 ? {} : and.length === 1 ? and[0] : { $and: and };
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Create a MongoDB-backed {@link MongoAuditStorage}. Connection is lazy: the
|
|
67
|
+
* client is created/connected on the first storage operation and reused
|
|
68
|
+
* thereafter, guarded by a single connection promise so concurrent calls connect
|
|
69
|
+
* once. Event indexes are created on the first event operation.
|
|
70
|
+
*
|
|
71
|
+
* @example
|
|
72
|
+
* ```ts
|
|
73
|
+
* import { createMongoStorage } from "@xtandard/audit/storage/mongodb";
|
|
74
|
+
*
|
|
75
|
+
* const storage = createMongoStorage({
|
|
76
|
+
* url: process.env.MONGODB_URL ?? "mongodb://localhost:27017",
|
|
77
|
+
* dbName: "myapp",
|
|
78
|
+
* });
|
|
79
|
+
*
|
|
80
|
+
* // Disconnect when the process exits:
|
|
81
|
+
* // process.on("SIGTERM", () => storage.close());
|
|
82
|
+
* ```
|
|
83
|
+
*/
|
|
84
|
+
function createMongoStorage(options) {
|
|
85
|
+
const { url, dbName = "xtandard_audit", collectionName = "audit_kv", eventsCollectionName = "audit_events" } = options;
|
|
86
|
+
const ownsClient = !options.client;
|
|
87
|
+
let client = options.client;
|
|
88
|
+
let connecting;
|
|
89
|
+
let indexing;
|
|
90
|
+
/** Resolve a connected client, creating/connecting it on first use. */
|
|
91
|
+
async function getClient() {
|
|
92
|
+
connecting ??= (async () => {
|
|
93
|
+
if (!client) {
|
|
94
|
+
let MongoClientCtor;
|
|
95
|
+
try {
|
|
96
|
+
({MongoClient: MongoClientCtor} = await import("mongodb"));
|
|
97
|
+
} catch {
|
|
98
|
+
require_contract.requirePeer("mongodb", "storage/mongodb");
|
|
99
|
+
}
|
|
100
|
+
if (url === void 0) throw new Error("@xtandard/audit/storage/mongodb requires either a \"client\" or a \"url\" option.");
|
|
101
|
+
client = new MongoClientCtor(url);
|
|
102
|
+
}
|
|
103
|
+
try {
|
|
104
|
+
await client.connect();
|
|
105
|
+
} catch (error) {
|
|
106
|
+
if (!isAlreadyConnected(error)) throw error;
|
|
107
|
+
}
|
|
108
|
+
return client;
|
|
109
|
+
})();
|
|
110
|
+
try {
|
|
111
|
+
return await connecting;
|
|
112
|
+
} catch (error) {
|
|
113
|
+
connecting = void 0;
|
|
114
|
+
throw error;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
async function getCollection() {
|
|
118
|
+
return (await getClient()).db(dbName).collection(collectionName);
|
|
119
|
+
}
|
|
120
|
+
/** The events collection, with its indexes ensured once. */
|
|
121
|
+
async function getEvents() {
|
|
122
|
+
indexing ??= (async () => {
|
|
123
|
+
const events = (await getClient()).db(dbName).collection(eventsCollectionName);
|
|
124
|
+
await events.createIndexes([
|
|
125
|
+
{
|
|
126
|
+
key: {
|
|
127
|
+
tenant: 1,
|
|
128
|
+
seq: 1
|
|
129
|
+
},
|
|
130
|
+
name: "tenant_seq",
|
|
131
|
+
unique: true
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
key: {
|
|
135
|
+
tenant: 1,
|
|
136
|
+
id: 1
|
|
137
|
+
},
|
|
138
|
+
name: "tenant_id",
|
|
139
|
+
unique: true
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
key: {
|
|
143
|
+
tenant: 1,
|
|
144
|
+
occurredAt: 1,
|
|
145
|
+
id: 1
|
|
146
|
+
},
|
|
147
|
+
name: "tenant_time"
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
key: {
|
|
151
|
+
tenant: 1,
|
|
152
|
+
"actor.id": 1,
|
|
153
|
+
occurredAt: 1,
|
|
154
|
+
id: 1
|
|
155
|
+
},
|
|
156
|
+
name: "tenant_actor"
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
key: {
|
|
160
|
+
tenant: 1,
|
|
161
|
+
action: 1,
|
|
162
|
+
occurredAt: 1,
|
|
163
|
+
id: 1
|
|
164
|
+
},
|
|
165
|
+
name: "tenant_action"
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
key: {
|
|
169
|
+
tenant: 1,
|
|
170
|
+
"targets.type": 1,
|
|
171
|
+
"targets.id": 1
|
|
172
|
+
},
|
|
173
|
+
name: "tenant_targets"
|
|
174
|
+
}
|
|
175
|
+
]);
|
|
176
|
+
return events;
|
|
177
|
+
})();
|
|
178
|
+
try {
|
|
179
|
+
return await indexing;
|
|
180
|
+
} catch (error) {
|
|
181
|
+
indexing = void 0;
|
|
182
|
+
throw error;
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
return {
|
|
186
|
+
async getItem(key) {
|
|
187
|
+
const doc = await (await getCollection()).findOne({ _id: key });
|
|
188
|
+
return doc ? doc.value : null;
|
|
189
|
+
},
|
|
190
|
+
async setItem(key, value) {
|
|
191
|
+
await (await getCollection()).updateOne({ _id: key }, { $set: { value } }, { upsert: true });
|
|
192
|
+
},
|
|
193
|
+
async removeItem(key) {
|
|
194
|
+
await (await getCollection()).deleteOne({ _id: key });
|
|
195
|
+
},
|
|
196
|
+
async getKeys(prefix) {
|
|
197
|
+
const cursor = (await getCollection()).find({ _id: { $regex: `^${escapeRegex(prefix)}` } }).project({ _id: 1 });
|
|
198
|
+
const out = [];
|
|
199
|
+
for await (const doc of cursor) out.push(doc._id);
|
|
200
|
+
return out;
|
|
201
|
+
},
|
|
202
|
+
async appendEvents(tenant, batch, { expectedSeq }) {
|
|
203
|
+
if (batch.length === 0) return;
|
|
204
|
+
batch.forEach((e, i) => {
|
|
205
|
+
if (e.tenant !== tenant || e.seq !== expectedSeq + i + 1) throw new require_contract.ChainConflictError(tenant, expectedSeq);
|
|
206
|
+
});
|
|
207
|
+
const events = await getEvents();
|
|
208
|
+
const last = await events.findOne({ tenant }, {
|
|
209
|
+
sort: { seq: -1 },
|
|
210
|
+
projection: {
|
|
211
|
+
_id: 0,
|
|
212
|
+
seq: 1
|
|
213
|
+
}
|
|
214
|
+
});
|
|
215
|
+
if (last && last.seq !== expectedSeq) throw new require_contract.ChainConflictError(tenant, expectedSeq);
|
|
216
|
+
try {
|
|
217
|
+
await events.insertMany(batch.map(toDoc), {
|
|
218
|
+
ordered: true,
|
|
219
|
+
ignoreUndefined: true
|
|
220
|
+
});
|
|
221
|
+
} catch (error) {
|
|
222
|
+
if (!isDuplicateKey(error)) throw error;
|
|
223
|
+
const ids = batch.map((e) => e.id);
|
|
224
|
+
const hashes = batch.map((e) => e.integrity.hash);
|
|
225
|
+
if (!await events.findOne({
|
|
226
|
+
tenant,
|
|
227
|
+
id: { $nin: ids },
|
|
228
|
+
"integrity.prevHash": { $in: hashes }
|
|
229
|
+
}, { projection: { _id: 1 } })) await events.deleteMany({
|
|
230
|
+
tenant,
|
|
231
|
+
$or: batch.map((e) => ({
|
|
232
|
+
id: e.id,
|
|
233
|
+
seq: e.seq,
|
|
234
|
+
"integrity.hash": e.integrity.hash
|
|
235
|
+
}))
|
|
236
|
+
});
|
|
237
|
+
throw new require_contract.ChainConflictError(tenant, expectedSeq);
|
|
238
|
+
}
|
|
239
|
+
},
|
|
240
|
+
async getEvent(tenant, id) {
|
|
241
|
+
return (await getEvents()).findOne({
|
|
242
|
+
tenant,
|
|
243
|
+
id
|
|
244
|
+
}, { projection: EVENT_PROJECTION });
|
|
245
|
+
},
|
|
246
|
+
async lastEvent(tenant) {
|
|
247
|
+
return (await getEvents()).findOne({ tenant }, {
|
|
248
|
+
sort: { seq: -1 },
|
|
249
|
+
projection: EVENT_PROJECTION
|
|
250
|
+
});
|
|
251
|
+
},
|
|
252
|
+
async eventsBySeq(tenant, { afterSeq, limit }) {
|
|
253
|
+
return (await getEvents()).find({
|
|
254
|
+
tenant,
|
|
255
|
+
seq: { $gt: afterSeq }
|
|
256
|
+
}, { projection: EVENT_PROJECTION }).sort({ seq: 1 }).limit(limit).toArray();
|
|
257
|
+
},
|
|
258
|
+
async queryEvents(q) {
|
|
259
|
+
const events = await getEvents();
|
|
260
|
+
const dir = q.order === "desc" ? -1 : 1;
|
|
261
|
+
const rows = await events.find(mongoEventFilter(q), { projection: EVENT_PROJECTION }).sort({
|
|
262
|
+
occurredAt: dir,
|
|
263
|
+
id: dir
|
|
264
|
+
}).limit(q.limit + 1).toArray();
|
|
265
|
+
return {
|
|
266
|
+
items: rows.slice(0, q.limit),
|
|
267
|
+
hasMore: rows.length > q.limit
|
|
268
|
+
};
|
|
269
|
+
},
|
|
270
|
+
async replaceEvent(event) {
|
|
271
|
+
await (await getEvents()).replaceOne({
|
|
272
|
+
tenant: event.tenant,
|
|
273
|
+
id: event.id,
|
|
274
|
+
seq: event.seq
|
|
275
|
+
}, toDoc(event), { ignoreUndefined: true });
|
|
276
|
+
},
|
|
277
|
+
async deleteEventsThrough(tenant, throughSeq) {
|
|
278
|
+
return (await (await getEvents()).deleteMany({
|
|
279
|
+
tenant,
|
|
280
|
+
seq: { $lte: throughSeq }
|
|
281
|
+
})).deletedCount;
|
|
282
|
+
},
|
|
283
|
+
async countEvents(tenant) {
|
|
284
|
+
return (await getEvents()).countDocuments(tenant !== void 0 ? { tenant } : {});
|
|
285
|
+
},
|
|
286
|
+
async listEventTenants() {
|
|
287
|
+
return (await (await getEvents()).distinct("tenant")).sort();
|
|
288
|
+
},
|
|
289
|
+
async close() {
|
|
290
|
+
if (ownsClient && client) await client.close();
|
|
291
|
+
}
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* Heuristic: does this error indicate the client was already connected? The
|
|
296
|
+
* driver's exact message has varied across versions, so match loosely.
|
|
297
|
+
*/
|
|
298
|
+
function isAlreadyConnected(error) {
|
|
299
|
+
const message = error instanceof Error ? error.message.toLowerCase() : "";
|
|
300
|
+
return message.includes("already") && message.includes("connect");
|
|
301
|
+
}
|
|
302
|
+
//#endregion
|
|
303
|
+
exports.createMongoStorage = createMongoStorage;
|
|
304
|
+
exports.mongoEventFilter = mongoEventFilter;
|
|
305
|
+
|
|
306
|
+
//# sourceMappingURL=entry-storage-mongodb.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entry-storage-mongodb.cjs","names":["searchText","ChainConflictError"],"sources":["../src/storage/mongodb.ts"],"sourcesContent":["/**\n * MongoDB storage adapter built on the [`mongodb`](https://github.com/mongodb/node-mongodb-native)\n * driver, an optional peer dependency. You can either pass a pre-constructed\n * (optionally pre-connected) `MongoClient`, or a connection `url` to create and\n * connect a client lazily on first use.\n *\n * Two collections:\n *\n * - **KV** (`audit_kv` by default) — `{ _id: <key>, value: <any> }` documents\n * for control data (catalog, chain heads, checkpoints, stream cursors). The\n * storage key is the document `_id`; the value is stored directly as BSON.\n * `getKeys(prefix)` matches `_id` against an anchored regular expression\n * (`^<escaped prefix>`), projecting only `_id`.\n * - **Events** (`audit_events` by default) — the native\n * {@link EventLogStorage} capability (ADR 0005): one document per event (the\n * event itself plus a denormalized, lower-cased `search` field), with a\n * unique index on `(tenant, seq)` and `(tenant, id)`, and indexes on\n * `(tenant, occurredAt, id)`, `(tenant, actor.id, …)`, `(tenant, action, …)`\n * and a multikey index on `targets`. Indexes are created on first use.\n * Queries compile to Mongo filters (`$in`/anchored regex for actions,\n * `$elemMatch` for targets, an escaped regex over `search`) with keyset\n * pagination via `$or` on `(occurredAt, id)`.\n *\n * ## Appends without transactions\n *\n * `appendEvents` checks the tenant's current max `seq` equals `expectedSeq`,\n * then `insertMany`s the batch (ordered). A concurrent writer that slips in\n * between trips the unique `(tenant, seq)` index: the adapter deletes whatever\n * this call inserted (unless another writer already chained onto it) and throws\n * {@link ChainConflictError}, so the core re-reads the head and re-chains. No\n * replica set or transactions are required. Event metadata may contain `$`- or\n * `.`-prefixed keys (erasure writes `{ $erased: true }`), which needs MongoDB\n * 5.0+.\n *\n * ## Why no `watch`\n *\n * MongoDB change streams (the natural way to back `WatchableAuditStorage`)\n * require a replica set or sharded cluster — they are unavailable on a standalone\n * `mongod`. To keep this adapter usable against any deployment, `watch` is\n * intentionally **not** implemented; the core feature-detects its absence and\n * falls back to polling. Wrap it with `withWatch` to supply your own signal.\n *\n * @module\n */\n\nimport type { Collection, Document, Filter, MongoClient } from \"mongodb\";\nimport { searchText, type NormalizedQuery } from \"../query.ts\";\nimport type { AuditEvent } from \"../schema.ts\";\nimport { ChainConflictError, requirePeer } from \"./contract.ts\";\nimport type { EventLogStorage } from \"./contract.ts\";\n\n/** Options for {@link createMongoStorage}. */\nexport interface MongoStorageOptions {\n /** A pre-constructed (optionally pre-connected) mongodb `MongoClient`. */\n client?: MongoClient;\n /**\n * Connection string (e.g. `mongodb://localhost:27017`). When no `client` is\n * given, a `MongoClient` is created lazily on first use via a dynamic\n * `import(\"mongodb\")`.\n */\n url?: string;\n /** Database name. Defaults to `\"xtandard_audit\"`. */\n dbName?: string;\n /** KV collection name. Defaults to `\"audit_kv\"`. */\n collectionName?: string;\n /** Events collection name. Defaults to `\"audit_events\"`. */\n eventsCollectionName?: string;\n}\n\n/**\n * An {@link EventLogStorage} backed by MongoDB, plus a `close()` method that\n * disconnects the client — but only the one this adapter created. A client you\n * passed in is left for you to manage.\n *\n * Note: `watch` is deliberately absent (see the module docs).\n */\nexport interface MongoAuditStorage extends EventLogStorage {\n /** Disconnect the underlying client if this adapter created it. No-op otherwise. */\n close(): Promise<void>;\n}\n\n/** Shape of a single key/value document stored in the KV collection. */\ninterface KvDoc extends Document {\n /** The storage key, stored verbatim as the Mongo document id. */\n _id: string;\n /** The stored value — arbitrary BSON (object, array, or primitive). */\n value: unknown;\n}\n\n/** An event document: the event plus its denormalized search text. */\ntype EventDoc = AuditEvent & { search: string };\n\n/** Read projection: hand back exactly the stored event. */\nconst EVENT_PROJECTION = { _id: 0, search: 0 } as const;\n\n/**\n * Escape characters that are special in a regular expression so a literal\n * string can be embedded into a pattern.\n */\nfunction escapeRegex(input: string): string {\n return input.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/** Anchored \"starts with\" regex for a literal prefix. */\nconst startsWith = (prefix: string): RegExp => new RegExp(`^${escapeRegex(prefix)}`);\n\nconst toDoc = (event: AuditEvent): EventDoc => ({ ...event, search: searchText(event) });\n\n/** Is this a duplicate-key (E11000) error, top-level or inside a bulk write? */\nfunction isDuplicateKey(error: unknown): boolean {\n const e = error as { code?: number; writeErrors?: Array<{ code?: number }> } | null;\n if (e?.code === 11000) return true;\n return Array.isArray(e?.writeErrors) && e.writeErrors.some((w) => w.code === 11000);\n}\n\n/**\n * Compile a {@link NormalizedQuery} to a Mongo filter that agrees exactly with\n * `matchesQuery` (plus the keyset position when the query has one).\n */\nexport function mongoEventFilter(q: NormalizedQuery): Filter<EventDoc> {\n const and: Filter<EventDoc>[] = [];\n if (q.tenant !== undefined) and.push({ tenant: q.tenant });\n\n // Actions: (no include list) OR exact OR family prefix; then excludes.\n if ((q.actions.length > 0 || q.actionPrefixes.length > 0) && !q.actionPrefixes.includes(\"\")) {\n const include: Filter<EventDoc>[] = [];\n if (q.actions.length > 0) include.push({ action: { $in: q.actions } });\n for (const p of q.actionPrefixes) include.push({ action: { $regex: startsWith(p) } });\n and.push(include.length === 1 ? include[0]! : { $or: include });\n }\n if (q.excludeActions.length > 0) and.push({ action: { $nin: q.excludeActions } });\n for (const p of q.excludeActionPrefixes) and.push({ action: { $not: startsWith(p) } });\n\n if (q.actorId !== undefined) and.push({ \"actor.id\": q.actorId });\n if (q.actorType !== undefined) {\n // A missing actor type means \"user\".\n and.push({\n \"actor.type\": q.actorType === \"user\" ? { $in: [\"user\", null] } : q.actorType,\n } as Filter<EventDoc>);\n }\n if (q.targetType !== undefined || q.targetId !== undefined) {\n and.push({\n targets: {\n $elemMatch: {\n ...(q.targetType !== undefined ? { type: q.targetType } : {}),\n ...(q.targetId !== undefined ? { id: q.targetId } : {}),\n },\n },\n } as Filter<EventDoc>);\n }\n if (q.outcome !== undefined) and.push({ outcome: q.outcome });\n if (q.from !== undefined || q.to !== undefined) {\n and.push({\n occurredAt: {\n ...(q.from !== undefined ? { $gte: q.from } : {}),\n ...(q.to !== undefined ? { $lt: q.to } : {}),\n },\n });\n }\n if (q.search !== undefined) and.push({ search: { $regex: new RegExp(escapeRegex(q.search)) } });\n\n if (q.after) {\n const op = q.order === \"desc\" ? \"$lt\" : \"$gt\";\n and.push({\n $or: [\n { occurredAt: { [op]: q.after.occurredAt } },\n { occurredAt: q.after.occurredAt, id: { [op]: q.after.id } },\n ],\n } as Filter<EventDoc>);\n }\n return and.length === 0 ? {} : and.length === 1 ? and[0]! : { $and: and };\n}\n\n/**\n * Create a MongoDB-backed {@link MongoAuditStorage}. Connection is lazy: the\n * client is created/connected on the first storage operation and reused\n * thereafter, guarded by a single connection promise so concurrent calls connect\n * once. Event indexes are created on the first event operation.\n *\n * @example\n * ```ts\n * import { createMongoStorage } from \"@xtandard/audit/storage/mongodb\";\n *\n * const storage = createMongoStorage({\n * url: process.env.MONGODB_URL ?? \"mongodb://localhost:27017\",\n * dbName: \"myapp\",\n * });\n *\n * // Disconnect when the process exits:\n * // process.on(\"SIGTERM\", () => storage.close());\n * ```\n */\nexport function createMongoStorage(options: MongoStorageOptions): MongoAuditStorage {\n const {\n url,\n dbName = \"xtandard_audit\",\n collectionName = \"audit_kv\",\n eventsCollectionName = \"audit_events\",\n } = options;\n const ownsClient = !options.client;\n\n let client: MongoClient | undefined = options.client;\n let connecting: Promise<MongoClient> | undefined;\n let indexing: Promise<Collection<EventDoc>> | undefined;\n\n /** Resolve a connected client, creating/connecting it on first use. */\n async function getClient(): Promise<MongoClient> {\n connecting ??= (async () => {\n if (!client) {\n let MongoClientCtor: new (url: string) => MongoClient;\n try {\n ({ MongoClient: MongoClientCtor } = (await import(\"mongodb\")) as unknown as {\n MongoClient: new (url: string) => MongoClient;\n });\n } catch {\n requirePeer(\"mongodb\", \"storage/mongodb\");\n }\n if (url === undefined) {\n throw new Error(\n '@xtandard/audit/storage/mongodb requires either a \"client\" or a \"url\" option.',\n );\n }\n client = new MongoClientCtor(url);\n }\n // node-mongodb's connect() is idempotent — calling it on an already\n // connected client is a no-op — but guard regardless so a passed-in,\n // already-connected client never surfaces a spurious error.\n try {\n await client.connect();\n } catch (error) {\n if (!isAlreadyConnected(error)) throw error;\n }\n return client;\n })();\n try {\n return await connecting;\n } catch (error) {\n // Let a later operation retry the connection rather than caching a failure.\n connecting = undefined;\n throw error;\n }\n }\n\n async function getCollection(): Promise<Collection<KvDoc>> {\n return (await getClient()).db(dbName).collection<KvDoc>(collectionName);\n }\n\n /** The events collection, with its indexes ensured once. */\n async function getEvents(): Promise<Collection<EventDoc>> {\n indexing ??= (async () => {\n const events = (await getClient()).db(dbName).collection<EventDoc>(eventsCollectionName);\n await events.createIndexes([\n { key: { tenant: 1, seq: 1 }, name: \"tenant_seq\", unique: true },\n { key: { tenant: 1, id: 1 }, name: \"tenant_id\", unique: true },\n { key: { tenant: 1, occurredAt: 1, id: 1 }, name: \"tenant_time\" },\n { key: { tenant: 1, \"actor.id\": 1, occurredAt: 1, id: 1 }, name: \"tenant_actor\" },\n { key: { tenant: 1, action: 1, occurredAt: 1, id: 1 }, name: \"tenant_action\" },\n { key: { tenant: 1, \"targets.type\": 1, \"targets.id\": 1 }, name: \"tenant_targets\" },\n ]);\n return events;\n })();\n try {\n return await indexing;\n } catch (error) {\n indexing = undefined;\n throw error;\n }\n }\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const collection = await getCollection();\n const doc = await collection.findOne({ _id: key });\n return doc ? (doc.value as T) : null;\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n const collection = await getCollection();\n await collection.updateOne({ _id: key }, { $set: { value } }, { upsert: true });\n },\n\n async removeItem(key: string): Promise<void> {\n const collection = await getCollection();\n await collection.deleteOne({ _id: key });\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n const collection = await getCollection();\n const cursor = collection\n .find({ _id: { $regex: `^${escapeRegex(prefix)}` } })\n .project<{ _id: string }>({ _id: 1 });\n const out: string[] = [];\n for await (const doc of cursor) out.push(doc._id);\n return out;\n },\n\n async appendEvents(tenant, batch, { expectedSeq }): Promise<void> {\n if (batch.length === 0) return;\n batch.forEach((e, i) => {\n if (e.tenant !== tenant || e.seq !== expectedSeq + i + 1) {\n throw new ChainConflictError(tenant, expectedSeq);\n }\n });\n const events = await getEvents();\n const last = await events.findOne(\n { tenant },\n { sort: { seq: -1 }, projection: { _id: 0, seq: 1 } },\n );\n // An empty tenant accepts any expectedSeq (the core never prunes the head\n // event, so this only happens for a brand-new tenant or a manual wipe).\n if (last && last.seq !== expectedSeq) throw new ChainConflictError(tenant, expectedSeq);\n try {\n await events.insertMany(batch.map(toDoc), { ordered: true, ignoreUndefined: true });\n } catch (error) {\n if (!isDuplicateKey(error)) throw error;\n // Lost a race (or the ids exist): undo whatever this call inserted —\n // matched by exact (id, seq, hash) — unless another writer already chained\n // onto it, in which case removing it would break their chain.\n const ids = batch.map((e) => e.id);\n const hashes = batch.map((e) => e.integrity.hash);\n const builtOn = await events.findOne(\n { tenant, id: { $nin: ids }, \"integrity.prevHash\": { $in: hashes } },\n { projection: { _id: 1 } },\n );\n if (!builtOn) {\n await events.deleteMany({\n tenant,\n $or: batch.map((e) => ({ id: e.id, seq: e.seq, \"integrity.hash\": e.integrity.hash })),\n });\n }\n throw new ChainConflictError(tenant, expectedSeq);\n }\n },\n\n async getEvent(tenant, id): Promise<AuditEvent | null> {\n const events = await getEvents();\n return events.findOne<AuditEvent>({ tenant, id }, { projection: EVENT_PROJECTION });\n },\n\n async lastEvent(tenant): Promise<AuditEvent | null> {\n const events = await getEvents();\n return events.findOne<AuditEvent>(\n { tenant },\n { sort: { seq: -1 }, projection: EVENT_PROJECTION },\n );\n },\n\n async eventsBySeq(tenant, { afterSeq, limit }): Promise<AuditEvent[]> {\n const events = await getEvents();\n return events\n .find<AuditEvent>({ tenant, seq: { $gt: afterSeq } }, { projection: EVENT_PROJECTION })\n .sort({ seq: 1 })\n .limit(limit)\n .toArray();\n },\n\n async queryEvents(q: NormalizedQuery) {\n const events = await getEvents();\n const dir = q.order === \"desc\" ? -1 : 1;\n const rows = await events\n .find<AuditEvent>(mongoEventFilter(q), { projection: EVENT_PROJECTION })\n .sort({ occurredAt: dir, id: dir })\n .limit(q.limit + 1)\n .toArray();\n return { items: rows.slice(0, q.limit), hasMore: rows.length > q.limit };\n },\n\n async replaceEvent(event): Promise<void> {\n const events = await getEvents();\n await events.replaceOne(\n { tenant: event.tenant, id: event.id, seq: event.seq },\n toDoc(event),\n { ignoreUndefined: true },\n );\n },\n\n async deleteEventsThrough(tenant, throughSeq): Promise<number> {\n const events = await getEvents();\n const result = await events.deleteMany({ tenant, seq: { $lte: throughSeq } });\n return result.deletedCount;\n },\n\n async countEvents(tenant): Promise<number> {\n const events = await getEvents();\n return events.countDocuments(tenant !== undefined ? { tenant } : {});\n },\n\n async listEventTenants(): Promise<string[]> {\n const events = await getEvents();\n return ((await events.distinct(\"tenant\")) as string[]).sort();\n },\n\n async close(): Promise<void> {\n if (ownsClient && client) await client.close();\n },\n } satisfies MongoAuditStorage;\n}\n\n/**\n * Heuristic: does this error indicate the client was already connected? The\n * driver's exact message has varied across versions, so match loosely.\n */\nfunction isAlreadyConnected(error: unknown): boolean {\n const message = error instanceof Error ? error.message.toLowerCase() : \"\";\n return message.includes(\"already\") && message.includes(\"connect\");\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { s as AuditEvent } from "./schema-DmU7Wp0F.cjs";
|
|
2
|
+
import { h as NormalizedQuery, i as EventLogStorage } from "./contract-CWJSYoJl.cjs";
|
|
3
|
+
import { Filter, MongoClient } from "mongodb";
|
|
4
|
+
|
|
5
|
+
//#region src/storage/mongodb.d.ts
|
|
6
|
+
/** Options for {@link createMongoStorage}. */
|
|
7
|
+
interface MongoStorageOptions {
|
|
8
|
+
/** A pre-constructed (optionally pre-connected) mongodb `MongoClient`. */
|
|
9
|
+
client?: MongoClient;
|
|
10
|
+
/**
|
|
11
|
+
* Connection string (e.g. `mongodb://localhost:27017`). When no `client` is
|
|
12
|
+
* given, a `MongoClient` is created lazily on first use via a dynamic
|
|
13
|
+
* `import("mongodb")`.
|
|
14
|
+
*/
|
|
15
|
+
url?: string;
|
|
16
|
+
/** Database name. Defaults to `"xtandard_audit"`. */
|
|
17
|
+
dbName?: string;
|
|
18
|
+
/** KV collection name. Defaults to `"audit_kv"`. */
|
|
19
|
+
collectionName?: string;
|
|
20
|
+
/** Events collection name. Defaults to `"audit_events"`. */
|
|
21
|
+
eventsCollectionName?: string;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* An {@link EventLogStorage} backed by MongoDB, plus a `close()` method that
|
|
25
|
+
* disconnects the client — but only the one this adapter created. A client you
|
|
26
|
+
* passed in is left for you to manage.
|
|
27
|
+
*
|
|
28
|
+
* Note: `watch` is deliberately absent (see the module docs).
|
|
29
|
+
*/
|
|
30
|
+
interface MongoAuditStorage extends EventLogStorage {
|
|
31
|
+
/** Disconnect the underlying client if this adapter created it. No-op otherwise. */
|
|
32
|
+
close(): Promise<void>;
|
|
33
|
+
}
|
|
34
|
+
/** An event document: the event plus its denormalized search text. */
|
|
35
|
+
type EventDoc = AuditEvent & {
|
|
36
|
+
search: string;
|
|
37
|
+
};
|
|
38
|
+
/**
|
|
39
|
+
* Compile a {@link NormalizedQuery} to a Mongo filter that agrees exactly with
|
|
40
|
+
* `matchesQuery` (plus the keyset position when the query has one).
|
|
41
|
+
*/
|
|
42
|
+
declare function mongoEventFilter(q: NormalizedQuery): Filter<EventDoc>;
|
|
43
|
+
/**
|
|
44
|
+
* Create a MongoDB-backed {@link MongoAuditStorage}. Connection is lazy: the
|
|
45
|
+
* client is created/connected on the first storage operation and reused
|
|
46
|
+
* thereafter, guarded by a single connection promise so concurrent calls connect
|
|
47
|
+
* once. Event indexes are created on the first event operation.
|
|
48
|
+
*
|
|
49
|
+
* @example
|
|
50
|
+
* ```ts
|
|
51
|
+
* import { createMongoStorage } from "@xtandard/audit/storage/mongodb";
|
|
52
|
+
*
|
|
53
|
+
* const storage = createMongoStorage({
|
|
54
|
+
* url: process.env.MONGODB_URL ?? "mongodb://localhost:27017",
|
|
55
|
+
* dbName: "myapp",
|
|
56
|
+
* });
|
|
57
|
+
*
|
|
58
|
+
* // Disconnect when the process exits:
|
|
59
|
+
* // process.on("SIGTERM", () => storage.close());
|
|
60
|
+
* ```
|
|
61
|
+
*/
|
|
62
|
+
declare function createMongoStorage(options: MongoStorageOptions): MongoAuditStorage;
|
|
63
|
+
//#endregion
|
|
64
|
+
export { MongoAuditStorage, MongoStorageOptions, createMongoStorage, mongoEventFilter };
|
|
65
|
+
//# sourceMappingURL=entry-storage-mongodb.d.cts.map
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { s as AuditEvent } from "./schema-DmU7Wp0F.mjs";
|
|
2
|
+
import { h as NormalizedQuery, i as EventLogStorage } from "./contract-BmwHIiMR.mjs";
|
|
3
|
+
import { Filter, MongoClient } from "mongodb";
|
|
4
|
+
|
|
5
|
+
//#region src/storage/mongodb.d.ts
|
|
6
|
+
/** Options for {@link createMongoStorage}. */
|
|
7
|
+
interface MongoStorageOptions {
|
|
8
|
+
/** A pre-constructed (optionally pre-connected) mongodb `MongoClient`. */
|
|
9
|
+
client?: MongoClient;
|
|
10
|
+
/**
|
|
11
|
+
* Connection string (e.g. `mongodb://localhost:27017`). When no `client` is
|
|
12
|
+
* given, a `MongoClient` is created lazily on first use via a dynamic
|
|
13
|
+
* `import("mongodb")`.
|
|
14
|
+
*/
|
|
15
|
+
url?: string;
|
|
16
|
+
/** Database name. Defaults to `"xtandard_audit"`. */
|
|
17
|
+
dbName?: string;
|
|
18
|
+
/** KV collection name. Defaults to `"audit_kv"`. */
|
|
19
|
+
collectionName?: string;
|
|
20
|
+
/** Events collection name. Defaults to `"audit_events"`. */
|
|
21
|
+
eventsCollectionName?: string;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* An {@link EventLogStorage} backed by MongoDB, plus a `close()` method that
|
|
25
|
+
* disconnects the client — but only the one this adapter created. A client you
|
|
26
|
+
* passed in is left for you to manage.
|
|
27
|
+
*
|
|
28
|
+
* Note: `watch` is deliberately absent (see the module docs).
|
|
29
|
+
*/
|
|
30
|
+
interface MongoAuditStorage extends EventLogStorage {
|
|
31
|
+
/** Disconnect the underlying client if this adapter created it. No-op otherwise. */
|
|
32
|
+
close(): Promise<void>;
|
|
33
|
+
}
|
|
34
|
+
/** An event document: the event plus its denormalized search text. */
|
|
35
|
+
type EventDoc = AuditEvent & {
|
|
36
|
+
search: string;
|
|
37
|
+
};
|
|
38
|
+
/**
|
|
39
|
+
* Compile a {@link NormalizedQuery} to a Mongo filter that agrees exactly with
|
|
40
|
+
* `matchesQuery` (plus the keyset position when the query has one).
|
|
41
|
+
*/
|
|
42
|
+
declare function mongoEventFilter(q: NormalizedQuery): Filter<EventDoc>;
|
|
43
|
+
/**
|
|
44
|
+
* Create a MongoDB-backed {@link MongoAuditStorage}. Connection is lazy: the
|
|
45
|
+
* client is created/connected on the first storage operation and reused
|
|
46
|
+
* thereafter, guarded by a single connection promise so concurrent calls connect
|
|
47
|
+
* once. Event indexes are created on the first event operation.
|
|
48
|
+
*
|
|
49
|
+
* @example
|
|
50
|
+
* ```ts
|
|
51
|
+
* import { createMongoStorage } from "@xtandard/audit/storage/mongodb";
|
|
52
|
+
*
|
|
53
|
+
* const storage = createMongoStorage({
|
|
54
|
+
* url: process.env.MONGODB_URL ?? "mongodb://localhost:27017",
|
|
55
|
+
* dbName: "myapp",
|
|
56
|
+
* });
|
|
57
|
+
*
|
|
58
|
+
* // Disconnect when the process exits:
|
|
59
|
+
* // process.on("SIGTERM", () => storage.close());
|
|
60
|
+
* ```
|
|
61
|
+
*/
|
|
62
|
+
declare function createMongoStorage(options: MongoStorageOptions): MongoAuditStorage;
|
|
63
|
+
//#endregion
|
|
64
|
+
export { MongoAuditStorage, MongoStorageOptions, createMongoStorage, mongoEventFilter };
|
|
65
|
+
//# sourceMappingURL=entry-storage-mongodb.d.mts.map
|