@xtandard/audit 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +384 -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 +31935 -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-Cd-mcIwC.css +1 -0
- package/dist/ui/assets/index-DUAgpiot.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,84 @@
|
|
|
1
|
+
import { n as assertSafeIdentifier, s as eventLogDdl } from "./sql-COjPyn3F.mjs";
|
|
2
|
+
import { t as createSqliteEventLog } from "./sqlite-event-log-nXmS2DS_.mjs";
|
|
3
|
+
import { Database } from "bun:sqlite";
|
|
4
|
+
//#region src/storage/sqlite.ts
|
|
5
|
+
/**
|
|
6
|
+
* SQLite storage adapter built on `bun:sqlite` — **Bun only**, zero npm deps.
|
|
7
|
+
* Ideal for single-node deployments and local/dev persistence: durable, fast, and
|
|
8
|
+
* file-backed (or in-memory). For multi-node runtimes prefer Postgres/libSQL.
|
|
9
|
+
*
|
|
10
|
+
* Control data lives in a key/value table; events live in the **native event
|
|
11
|
+
* log** tables `{table}_events` / `{table}_event_targets` (ADR 0005, see
|
|
12
|
+
* {@link ./sql}), so queries run on indexes instead of KV scans. Event-log
|
|
13
|
+
* writes run in `BEGIN IMMEDIATE` transactions, so several processes sharing
|
|
14
|
+
* one database file stay consistent.
|
|
15
|
+
*
|
|
16
|
+
* `bun:sqlite` is marked external at build time, so this module only resolves
|
|
17
|
+
* under the Bun runtime. Importing it under Node will throw — by design.
|
|
18
|
+
*
|
|
19
|
+
* ```ts
|
|
20
|
+
* import { createSqliteStorage } from "@xtandard/audit/storage/sqlite";
|
|
21
|
+
* const storage = createSqliteStorage({ path: "./audit.sqlite" });
|
|
22
|
+
* ```
|
|
23
|
+
*
|
|
24
|
+
* @module
|
|
25
|
+
*/
|
|
26
|
+
const escapeLike = (prefix) => prefix.replace(/[\\%_]/g, (c) => `\\${c}`);
|
|
27
|
+
/**
|
|
28
|
+
* Create a SQLite-backed storage. Requires the Bun runtime (`bun:sqlite`). The
|
|
29
|
+
* tables are created (`IF NOT EXISTS`) when the adapter is constructed.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* ```ts
|
|
33
|
+
* import { createSqliteStorage } from "@xtandard/audit/storage/sqlite";
|
|
34
|
+
*
|
|
35
|
+
* // File-backed (persists across restarts):
|
|
36
|
+
* const storage = createSqliteStorage({ path: "./audit.sqlite" });
|
|
37
|
+
*
|
|
38
|
+
* // In-memory (reset each run, useful for tests):
|
|
39
|
+
* // const storage = createSqliteStorage({ path: ":memory:" });
|
|
40
|
+
* ```
|
|
41
|
+
*/
|
|
42
|
+
function createSqliteStorage(options = {}) {
|
|
43
|
+
const table = assertSafeIdentifier(options.table ?? "xtandard_audit");
|
|
44
|
+
const ownsDb = !options.database;
|
|
45
|
+
const db = options.database ?? new Database(options.path ?? ":memory:");
|
|
46
|
+
db.run(`CREATE TABLE IF NOT EXISTS ${table} (key TEXT PRIMARY KEY, value TEXT NOT NULL)`);
|
|
47
|
+
for (const ddl of eventLogDdl("sqlite", table)) db.run(ddl);
|
|
48
|
+
const selectStmt = db.query(`SELECT value FROM ${table} WHERE key = ?`);
|
|
49
|
+
const upsertStmt = db.query(`INSERT INTO ${table} (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`);
|
|
50
|
+
const deleteStmt = db.query(`DELETE FROM ${table} WHERE key = ?`);
|
|
51
|
+
const keysStmt = db.query(`SELECT key FROM ${table} WHERE key LIKE ? ESCAPE '\\'`);
|
|
52
|
+
const atomic = db.transaction((statements) => statements.map((s) => db.query(s.sql).run(...s.args).changes));
|
|
53
|
+
const ready = Promise.resolve({
|
|
54
|
+
async all(sql, args) {
|
|
55
|
+
return db.query(sql).all(...args);
|
|
56
|
+
},
|
|
57
|
+
async atomic(statements) {
|
|
58
|
+
return atomic.immediate(statements);
|
|
59
|
+
}
|
|
60
|
+
});
|
|
61
|
+
return {
|
|
62
|
+
async getItem(key) {
|
|
63
|
+
const row = selectStmt.get(key);
|
|
64
|
+
return row ? JSON.parse(row.value) : null;
|
|
65
|
+
},
|
|
66
|
+
async setItem(key, value) {
|
|
67
|
+
upsertStmt.run(key, JSON.stringify(value));
|
|
68
|
+
},
|
|
69
|
+
async removeItem(key) {
|
|
70
|
+
deleteStmt.run(key);
|
|
71
|
+
},
|
|
72
|
+
async getKeys(prefix) {
|
|
73
|
+
return keysStmt.all(`${escapeLike(prefix)}%`).map((r) => r.key).filter((key) => key.startsWith(prefix));
|
|
74
|
+
},
|
|
75
|
+
...createSqliteEventLog(() => ready, table),
|
|
76
|
+
close() {
|
|
77
|
+
if (ownsDb) db.close();
|
|
78
|
+
}
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
//#endregion
|
|
82
|
+
export { createSqliteStorage };
|
|
83
|
+
|
|
84
|
+
//# sourceMappingURL=entry-storage-sqlite.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entry-storage-sqlite.mjs","names":[],"sources":["../src/storage/sqlite.ts"],"sourcesContent":["/**\n * SQLite storage adapter built on `bun:sqlite` — **Bun only**, zero npm deps.\n * Ideal for single-node deployments and local/dev persistence: durable, fast, and\n * file-backed (or in-memory). For multi-node runtimes prefer Postgres/libSQL.\n *\n * Control data lives in a key/value table; events live in the **native event\n * log** tables `{table}_events` / `{table}_event_targets` (ADR 0005, see\n * {@link ./sql}), so queries run on indexes instead of KV scans. Event-log\n * writes run in `BEGIN IMMEDIATE` transactions, so several processes sharing\n * one database file stay consistent.\n *\n * `bun:sqlite` is marked external at build time, so this module only resolves\n * under the Bun runtime. Importing it under Node will throw — by design.\n *\n * ```ts\n * import { createSqliteStorage } from \"@xtandard/audit/storage/sqlite\";\n * const storage = createSqliteStorage({ path: \"./audit.sqlite\" });\n * ```\n *\n * @module\n */\n\nimport { Database } from \"bun:sqlite\";\nimport type { EventLogStorage } from \"./contract.ts\";\nimport { createSqliteEventLog, type SqliteExecutor } from \"./sqlite-event-log.ts\";\nimport { assertSafeIdentifier, eventLogDdl, type SqlStatement } from \"./sql.ts\";\n\n/** Options for {@link createSqliteStorage}. */\nexport interface SqliteStorageOptions {\n /** File path for the database. Default `\":memory:\"`. Ignored when `database` is given. */\n path?: string;\n /** An existing `bun:sqlite` Database instance to use instead of opening one. */\n database?: Database;\n /**\n * KV table name (default `\"xtandard_audit\"`); the event log uses\n * `{table}_events` and `{table}_event_targets`. Validated as a safe identifier.\n */\n table?: string;\n}\n\n/** A storage backed by SQLite with the native {@link EventLogStorage}, plus `close()`. */\nexport interface SqliteAuditStorage extends EventLogStorage {\n /** Close the database if this adapter opened it; no-op for a borrowed instance. */\n close(): void;\n}\n\nconst escapeLike = (prefix: string): string => prefix.replace(/[\\\\%_]/g, (c) => `\\\\${c}`);\n\ntype Binding = string | number | bigint | boolean | null | Uint8Array;\n\n/**\n * Create a SQLite-backed storage. Requires the Bun runtime (`bun:sqlite`). The\n * tables are created (`IF NOT EXISTS`) when the adapter is constructed.\n *\n * @example\n * ```ts\n * import { createSqliteStorage } from \"@xtandard/audit/storage/sqlite\";\n *\n * // File-backed (persists across restarts):\n * const storage = createSqliteStorage({ path: \"./audit.sqlite\" });\n *\n * // In-memory (reset each run, useful for tests):\n * // const storage = createSqliteStorage({ path: \":memory:\" });\n * ```\n */\nexport function createSqliteStorage(options: SqliteStorageOptions = {}): SqliteAuditStorage {\n const table = assertSafeIdentifier(options.table ?? \"xtandard_audit\");\n\n const ownsDb = !options.database;\n const db = options.database ?? new Database(options.path ?? \":memory:\");\n db.run(`CREATE TABLE IF NOT EXISTS ${table} (key TEXT PRIMARY KEY, value TEXT NOT NULL)`);\n for (const ddl of eventLogDdl(\"sqlite\", table)) db.run(ddl);\n\n const selectStmt = db.query(`SELECT value FROM ${table} WHERE key = ?`);\n const upsertStmt = db.query(\n `INSERT INTO ${table} (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`,\n );\n const deleteStmt = db.query(`DELETE FROM ${table} WHERE key = ?`);\n const keysStmt = db.query(`SELECT key FROM ${table} WHERE key LIKE ? ESCAPE '\\\\'`);\n\n // Synchronous under the hood: a transaction can never interleave with another call.\n const atomic = db.transaction((statements: SqlStatement[]) =>\n statements.map((s) => db.query(s.sql).run(...(s.args as Binding[])).changes),\n );\n const executor: SqliteExecutor = {\n async all(sql, args) {\n return db.query(sql).all(...(args as Binding[])) as Array<Record<string, unknown>>;\n },\n async atomic(statements) {\n return atomic.immediate(statements);\n },\n };\n const ready = Promise.resolve(executor);\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const row = selectStmt.get(key) as { value: string } | null;\n return row ? (JSON.parse(row.value) as T) : null;\n },\n async setItem<T>(key: string, value: T): Promise<void> {\n upsertStmt.run(key, JSON.stringify(value));\n },\n async removeItem(key: string): Promise<void> {\n deleteStmt.run(key);\n },\n async getKeys(prefix: string): Promise<string[]> {\n const rows = keysStmt.all(`${escapeLike(prefix)}%`) as Array<{ key: string }>;\n // SQLite LIKE folds ASCII case: keep only exact prefix matches.\n return rows.map((r) => r.key).filter((key) => key.startsWith(prefix));\n },\n ...createSqliteEventLog(() => ready, table),\n close(): void {\n if (ownsDb) db.close();\n },\n } satisfies SqliteAuditStorage;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,cAAc,WAA2B,OAAO,QAAQ,YAAY,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;AAmBxF,SAAgB,oBAAoB,UAAgC,CAAC,GAAuB;CAC1F,MAAM,QAAQ,qBAAqB,QAAQ,SAAS,gBAAgB;CAEpE,MAAM,SAAS,CAAC,QAAQ;CACxB,MAAM,KAAK,QAAQ,YAAY,IAAI,SAAS,QAAQ,QAAQ,UAAU;CACtE,GAAG,IAAI,8BAA8B,MAAM,6CAA6C;CACxF,KAAK,MAAM,OAAO,YAAY,UAAU,KAAK,GAAG,GAAG,IAAI,GAAG;CAE1D,MAAM,aAAa,GAAG,MAAM,qBAAqB,MAAM,eAAe;CACtE,MAAM,aAAa,GAAG,MACpB,eAAe,MAAM,kFACvB;CACA,MAAM,aAAa,GAAG,MAAM,eAAe,MAAM,eAAe;CAChE,MAAM,WAAW,GAAG,MAAM,mBAAmB,MAAM,8BAA8B;CAGjF,MAAM,SAAS,GAAG,aAAa,eAC7B,WAAW,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,GAAI,EAAE,IAAkB,EAAE,OAAO,CAC7E;CASA,MAAM,QAAQ,QAAQ,QAAQ;EAP5B,MAAM,IAAI,KAAK,MAAM;GACnB,OAAO,GAAG,MAAM,GAAG,EAAE,IAAI,GAAI,IAAkB;EACjD;EACA,MAAM,OAAO,YAAY;GACvB,OAAO,OAAO,UAAU,UAAU;EACpC;CAEmC,CAAC;CAEtC,OAAO;EACL,MAAM,QAAW,KAAgC;GAC/C,MAAM,MAAM,WAAW,IAAI,GAAG;GAC9B,OAAO,MAAO,KAAK,MAAM,IAAI,KAAK,IAAU;EAC9C;EACA,MAAM,QAAW,KAAa,OAAyB;GACrD,WAAW,IAAI,KAAK,KAAK,UAAU,KAAK,CAAC;EAC3C;EACA,MAAM,WAAW,KAA4B;GAC3C,WAAW,IAAI,GAAG;EACpB;EACA,MAAM,QAAQ,QAAmC;GAG/C,OAFa,SAAS,IAAI,GAAG,WAAW,MAAM,EAAE,EAEtC,EAAE,KAAK,MAAM,EAAE,GAAG,EAAE,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;EACtE;EACA,GAAG,2BAA2B,OAAO,KAAK;EAC1C,QAAc;GACZ,IAAI,QAAQ,GAAG,MAAM;EACvB;CACF;AACF"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
//#region src/storage/unstorage.ts
|
|
3
|
+
const ESCAPES = {
|
|
4
|
+
"%": "%25",
|
|
5
|
+
"?": "%3F",
|
|
6
|
+
"\\": "%5C",
|
|
7
|
+
":": "%3A"
|
|
8
|
+
};
|
|
9
|
+
const UNESCAPES = {
|
|
10
|
+
"%25": "%",
|
|
11
|
+
"%3F": "?",
|
|
12
|
+
"%5C": "\\",
|
|
13
|
+
"%3A": ":"
|
|
14
|
+
};
|
|
15
|
+
/** Escape the characters unstorage would normalize away (segments keep their `/`). */
|
|
16
|
+
const toUnstorageKey = (key) => key.replace(/[%?\\:]/g, (ch) => ESCAPES[ch]);
|
|
17
|
+
/** Convert an unstorage `:`-separated key back to the original `/`-separated key. */
|
|
18
|
+
const fromUnstorageKey = (key) => key.replace(/:/g, "/").replace(/%(25|3F|5C|3A)/g, (m) => UNESCAPES[m]);
|
|
19
|
+
/**
|
|
20
|
+
* Create a {@link AuditStorage} backed by an unstorage `Storage` instance.
|
|
21
|
+
* unstorage auto-serializes/deserializes JSON values, so values round-trip
|
|
22
|
+
* structurally; missing keys read back as `null`.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```ts
|
|
26
|
+
* import { createUnstorageStorage } from "@xtandard/audit/storage/unstorage";
|
|
27
|
+
* import { createStorage } from "unstorage";
|
|
28
|
+
* import fsDriver from "unstorage/drivers/fs";
|
|
29
|
+
*
|
|
30
|
+
* const storage = createUnstorageStorage({
|
|
31
|
+
* storage: createStorage({ driver: fsDriver({ base: "./data/audit" }) }),
|
|
32
|
+
* });
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
function createUnstorageStorage(options) {
|
|
36
|
+
const { storage } = options;
|
|
37
|
+
return {
|
|
38
|
+
async getItem(key) {
|
|
39
|
+
const value = await storage.getItem(toUnstorageKey(key));
|
|
40
|
+
return value === void 0 ? null : value;
|
|
41
|
+
},
|
|
42
|
+
async setItem(key, value) {
|
|
43
|
+
await storage.setItem(toUnstorageKey(key), value);
|
|
44
|
+
},
|
|
45
|
+
async removeItem(key) {
|
|
46
|
+
await storage.removeItem(toUnstorageKey(key));
|
|
47
|
+
},
|
|
48
|
+
async getKeys(prefix) {
|
|
49
|
+
const base = prefix.slice(0, prefix.lastIndexOf("/") + 1);
|
|
50
|
+
return (await storage.getKeys(toUnstorageKey(base))).map(fromUnstorageKey).filter((key) => key.startsWith(prefix));
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
//#endregion
|
|
55
|
+
exports.createUnstorageStorage = createUnstorageStorage;
|
|
56
|
+
|
|
57
|
+
//# sourceMappingURL=entry-storage-unstorage.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entry-storage-unstorage.cjs","names":[],"sources":["../src/storage/unstorage.ts"],"sourcesContent":["/**\n * Adapter that wraps an [unstorage](https://unstorage.unjs.io) `Storage`\n * instance as a {@link AuditStorage}. The caller constructs and configures\n * their own unstorage instance (with whatever driver they like) and passes it in\n * — we never import `unstorage` at runtime, only its type. `unstorage` therefore\n * remains an optional peer dependency.\n *\n * unstorage normalizes key separators to `:` internally. We write `/`-style keys\n * (which unstorage accepts), but its `getKeys(base)` returns `:`-separated keys.\n * This adapter converts those back to `/` so callers always see the keys they\n * wrote.\n *\n * unstorage's key normalization is lossy (it cuts at `?`, turns `\\` and `/`\n * into `:`, and collapses repeated `:`), so the adapter escapes `%`, `?`, `\\`\n * and `:` inside segments before handing keys over and reverses it on the way\n * back: every key round-trips exactly.\n *\n * KV only: events go through the core's generic KV event log (ADR 0005), and\n * unstorage has no compare-and-swap, so the core assumes a **single writer per\n * tenant**. Note that filesystem-backed unstorage drivers inherit their\n * filesystem's case sensitivity; prefer `storage/file`, which encodes case.\n *\n * @module\n */\n\nimport type { Storage } from \"unstorage\";\nimport type { AuditStorage } from \"./contract.ts\";\n\n/** Options for {@link createUnstorageStorage}. */\nexport interface UnstorageStorageOptions {\n /** A pre-constructed unstorage `Storage` instance (any driver). */\n storage: Storage;\n}\n\nconst ESCAPES: Record<string, string> = { \"%\": \"%25\", \"?\": \"%3F\", \"\\\\\": \"%5C\", \":\": \"%3A\" };\nconst UNESCAPES: Record<string, string> = { \"%25\": \"%\", \"%3F\": \"?\", \"%5C\": \"\\\\\", \"%3A\": \":\" };\n\n/** Escape the characters unstorage would normalize away (segments keep their `/`). */\nconst toUnstorageKey = (key: string): string => key.replace(/[%?\\\\:]/g, (ch) => ESCAPES[ch]!);\n\n/** Convert an unstorage `:`-separated key back to the original `/`-separated key. */\nconst fromUnstorageKey = (key: string): string =>\n key.replace(/:/g, \"/\").replace(/%(25|3F|5C|3A)/g, (m) => UNESCAPES[m]!);\n\n/**\n * Create a {@link AuditStorage} backed by an unstorage `Storage` instance.\n * unstorage auto-serializes/deserializes JSON values, so values round-trip\n * structurally; missing keys read back as `null`.\n *\n * @example\n * ```ts\n * import { createUnstorageStorage } from \"@xtandard/audit/storage/unstorage\";\n * import { createStorage } from \"unstorage\";\n * import fsDriver from \"unstorage/drivers/fs\";\n *\n * const storage = createUnstorageStorage({\n * storage: createStorage({ driver: fsDriver({ base: \"./data/audit\" }) }),\n * });\n * ```\n */\nexport function createUnstorageStorage(options: UnstorageStorageOptions): AuditStorage {\n const { storage } = options;\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const value = await storage.getItem<T>(toUnstorageKey(key));\n return value === undefined ? null : value;\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n // unstorage's setItem rejects `undefined`; the contract never stores it.\n await storage.setItem(toUnstorageKey(key), value as NonNullable<T>);\n },\n\n async removeItem(key: string): Promise<void> {\n await storage.removeItem(toUnstorageKey(key));\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n // unstorage's getKeys takes a base and returns matching keys with `:`\n // separators; convert them back so callers get their original `/` keys.\n // unstorage treats the base as a namespace (`aud:x` lists `aud:x:*` only), while the\n // contract is a plain string prefix: list from the last `/` boundary, then filter.\n const base = prefix.slice(0, prefix.lastIndexOf(\"/\") + 1);\n const keys = await storage.getKeys(toUnstorageKey(base));\n return keys.map(fromUnstorageKey).filter((key) => key.startsWith(prefix));\n },\n } satisfies AuditStorage;\n}\n"],"mappings":";;AAkCA,MAAM,UAAkC;CAAE,KAAK;CAAO,KAAK;CAAO,MAAM;CAAO,KAAK;AAAM;AAC1F,MAAM,YAAoC;CAAE,OAAO;CAAK,OAAO;CAAK,OAAO;CAAM,OAAO;AAAI;;AAG5F,MAAM,kBAAkB,QAAwB,IAAI,QAAQ,aAAa,OAAO,QAAQ,GAAI;;AAG5F,MAAM,oBAAoB,QACxB,IAAI,QAAQ,MAAM,GAAG,EAAE,QAAQ,oBAAoB,MAAM,UAAU,EAAG;;;;;;;;;;;;;;;;;AAkBxE,SAAgB,uBAAuB,SAAgD;CACrF,MAAM,EAAE,YAAY;CAEpB,OAAO;EACL,MAAM,QAAW,KAAgC;GAC/C,MAAM,QAAQ,MAAM,QAAQ,QAAW,eAAe,GAAG,CAAC;GAC1D,OAAO,UAAU,KAAA,IAAY,OAAO;EACtC;EAEA,MAAM,QAAW,KAAa,OAAyB;GAErD,MAAM,QAAQ,QAAQ,eAAe,GAAG,GAAG,KAAuB;EACpE;EAEA,MAAM,WAAW,KAA4B;GAC3C,MAAM,QAAQ,WAAW,eAAe,GAAG,CAAC;EAC9C;EAEA,MAAM,QAAQ,QAAmC;GAK/C,MAAM,OAAO,OAAO,MAAM,GAAG,OAAO,YAAY,GAAG,IAAI,CAAC;GAExD,QAAO,MADY,QAAQ,QAAQ,eAAe,IAAI,CAAC,GAC3C,IAAI,gBAAgB,EAAE,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;EAC1E;CACF;AACF"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { t as AuditStorage } from "./contract-CWJSYoJl.cjs";
|
|
2
|
+
import { Storage } from "unstorage";
|
|
3
|
+
|
|
4
|
+
//#region src/storage/unstorage.d.ts
|
|
5
|
+
/** Options for {@link createUnstorageStorage}. */
|
|
6
|
+
interface UnstorageStorageOptions {
|
|
7
|
+
/** A pre-constructed unstorage `Storage` instance (any driver). */
|
|
8
|
+
storage: Storage;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Create a {@link AuditStorage} backed by an unstorage `Storage` instance.
|
|
12
|
+
* unstorage auto-serializes/deserializes JSON values, so values round-trip
|
|
13
|
+
* structurally; missing keys read back as `null`.
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* ```ts
|
|
17
|
+
* import { createUnstorageStorage } from "@xtandard/audit/storage/unstorage";
|
|
18
|
+
* import { createStorage } from "unstorage";
|
|
19
|
+
* import fsDriver from "unstorage/drivers/fs";
|
|
20
|
+
*
|
|
21
|
+
* const storage = createUnstorageStorage({
|
|
22
|
+
* storage: createStorage({ driver: fsDriver({ base: "./data/audit" }) }),
|
|
23
|
+
* });
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
declare function createUnstorageStorage(options: UnstorageStorageOptions): AuditStorage;
|
|
27
|
+
//#endregion
|
|
28
|
+
export { UnstorageStorageOptions, createUnstorageStorage };
|
|
29
|
+
//# sourceMappingURL=entry-storage-unstorage.d.cts.map
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { t as AuditStorage } from "./contract-BmwHIiMR.mjs";
|
|
2
|
+
import { Storage } from "unstorage";
|
|
3
|
+
|
|
4
|
+
//#region src/storage/unstorage.d.ts
|
|
5
|
+
/** Options for {@link createUnstorageStorage}. */
|
|
6
|
+
interface UnstorageStorageOptions {
|
|
7
|
+
/** A pre-constructed unstorage `Storage` instance (any driver). */
|
|
8
|
+
storage: Storage;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Create a {@link AuditStorage} backed by an unstorage `Storage` instance.
|
|
12
|
+
* unstorage auto-serializes/deserializes JSON values, so values round-trip
|
|
13
|
+
* structurally; missing keys read back as `null`.
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* ```ts
|
|
17
|
+
* import { createUnstorageStorage } from "@xtandard/audit/storage/unstorage";
|
|
18
|
+
* import { createStorage } from "unstorage";
|
|
19
|
+
* import fsDriver from "unstorage/drivers/fs";
|
|
20
|
+
*
|
|
21
|
+
* const storage = createUnstorageStorage({
|
|
22
|
+
* storage: createStorage({ driver: fsDriver({ base: "./data/audit" }) }),
|
|
23
|
+
* });
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
declare function createUnstorageStorage(options: UnstorageStorageOptions): AuditStorage;
|
|
27
|
+
//#endregion
|
|
28
|
+
export { UnstorageStorageOptions, createUnstorageStorage };
|
|
29
|
+
//# sourceMappingURL=entry-storage-unstorage.d.mts.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
//#region src/storage/unstorage.ts
|
|
2
|
+
const ESCAPES = {
|
|
3
|
+
"%": "%25",
|
|
4
|
+
"?": "%3F",
|
|
5
|
+
"\\": "%5C",
|
|
6
|
+
":": "%3A"
|
|
7
|
+
};
|
|
8
|
+
const UNESCAPES = {
|
|
9
|
+
"%25": "%",
|
|
10
|
+
"%3F": "?",
|
|
11
|
+
"%5C": "\\",
|
|
12
|
+
"%3A": ":"
|
|
13
|
+
};
|
|
14
|
+
/** Escape the characters unstorage would normalize away (segments keep their `/`). */
|
|
15
|
+
const toUnstorageKey = (key) => key.replace(/[%?\\:]/g, (ch) => ESCAPES[ch]);
|
|
16
|
+
/** Convert an unstorage `:`-separated key back to the original `/`-separated key. */
|
|
17
|
+
const fromUnstorageKey = (key) => key.replace(/:/g, "/").replace(/%(25|3F|5C|3A)/g, (m) => UNESCAPES[m]);
|
|
18
|
+
/**
|
|
19
|
+
* Create a {@link AuditStorage} backed by an unstorage `Storage` instance.
|
|
20
|
+
* unstorage auto-serializes/deserializes JSON values, so values round-trip
|
|
21
|
+
* structurally; missing keys read back as `null`.
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```ts
|
|
25
|
+
* import { createUnstorageStorage } from "@xtandard/audit/storage/unstorage";
|
|
26
|
+
* import { createStorage } from "unstorage";
|
|
27
|
+
* import fsDriver from "unstorage/drivers/fs";
|
|
28
|
+
*
|
|
29
|
+
* const storage = createUnstorageStorage({
|
|
30
|
+
* storage: createStorage({ driver: fsDriver({ base: "./data/audit" }) }),
|
|
31
|
+
* });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
function createUnstorageStorage(options) {
|
|
35
|
+
const { storage } = options;
|
|
36
|
+
return {
|
|
37
|
+
async getItem(key) {
|
|
38
|
+
const value = await storage.getItem(toUnstorageKey(key));
|
|
39
|
+
return value === void 0 ? null : value;
|
|
40
|
+
},
|
|
41
|
+
async setItem(key, value) {
|
|
42
|
+
await storage.setItem(toUnstorageKey(key), value);
|
|
43
|
+
},
|
|
44
|
+
async removeItem(key) {
|
|
45
|
+
await storage.removeItem(toUnstorageKey(key));
|
|
46
|
+
},
|
|
47
|
+
async getKeys(prefix) {
|
|
48
|
+
const base = prefix.slice(0, prefix.lastIndexOf("/") + 1);
|
|
49
|
+
return (await storage.getKeys(toUnstorageKey(base))).map(fromUnstorageKey).filter((key) => key.startsWith(prefix));
|
|
50
|
+
}
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
//#endregion
|
|
54
|
+
export { createUnstorageStorage };
|
|
55
|
+
|
|
56
|
+
//# sourceMappingURL=entry-storage-unstorage.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entry-storage-unstorage.mjs","names":[],"sources":["../src/storage/unstorage.ts"],"sourcesContent":["/**\n * Adapter that wraps an [unstorage](https://unstorage.unjs.io) `Storage`\n * instance as a {@link AuditStorage}. The caller constructs and configures\n * their own unstorage instance (with whatever driver they like) and passes it in\n * — we never import `unstorage` at runtime, only its type. `unstorage` therefore\n * remains an optional peer dependency.\n *\n * unstorage normalizes key separators to `:` internally. We write `/`-style keys\n * (which unstorage accepts), but its `getKeys(base)` returns `:`-separated keys.\n * This adapter converts those back to `/` so callers always see the keys they\n * wrote.\n *\n * unstorage's key normalization is lossy (it cuts at `?`, turns `\\` and `/`\n * into `:`, and collapses repeated `:`), so the adapter escapes `%`, `?`, `\\`\n * and `:` inside segments before handing keys over and reverses it on the way\n * back: every key round-trips exactly.\n *\n * KV only: events go through the core's generic KV event log (ADR 0005), and\n * unstorage has no compare-and-swap, so the core assumes a **single writer per\n * tenant**. Note that filesystem-backed unstorage drivers inherit their\n * filesystem's case sensitivity; prefer `storage/file`, which encodes case.\n *\n * @module\n */\n\nimport type { Storage } from \"unstorage\";\nimport type { AuditStorage } from \"./contract.ts\";\n\n/** Options for {@link createUnstorageStorage}. */\nexport interface UnstorageStorageOptions {\n /** A pre-constructed unstorage `Storage` instance (any driver). */\n storage: Storage;\n}\n\nconst ESCAPES: Record<string, string> = { \"%\": \"%25\", \"?\": \"%3F\", \"\\\\\": \"%5C\", \":\": \"%3A\" };\nconst UNESCAPES: Record<string, string> = { \"%25\": \"%\", \"%3F\": \"?\", \"%5C\": \"\\\\\", \"%3A\": \":\" };\n\n/** Escape the characters unstorage would normalize away (segments keep their `/`). */\nconst toUnstorageKey = (key: string): string => key.replace(/[%?\\\\:]/g, (ch) => ESCAPES[ch]!);\n\n/** Convert an unstorage `:`-separated key back to the original `/`-separated key. */\nconst fromUnstorageKey = (key: string): string =>\n key.replace(/:/g, \"/\").replace(/%(25|3F|5C|3A)/g, (m) => UNESCAPES[m]!);\n\n/**\n * Create a {@link AuditStorage} backed by an unstorage `Storage` instance.\n * unstorage auto-serializes/deserializes JSON values, so values round-trip\n * structurally; missing keys read back as `null`.\n *\n * @example\n * ```ts\n * import { createUnstorageStorage } from \"@xtandard/audit/storage/unstorage\";\n * import { createStorage } from \"unstorage\";\n * import fsDriver from \"unstorage/drivers/fs\";\n *\n * const storage = createUnstorageStorage({\n * storage: createStorage({ driver: fsDriver({ base: \"./data/audit\" }) }),\n * });\n * ```\n */\nexport function createUnstorageStorage(options: UnstorageStorageOptions): AuditStorage {\n const { storage } = options;\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const value = await storage.getItem<T>(toUnstorageKey(key));\n return value === undefined ? null : value;\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n // unstorage's setItem rejects `undefined`; the contract never stores it.\n await storage.setItem(toUnstorageKey(key), value as NonNullable<T>);\n },\n\n async removeItem(key: string): Promise<void> {\n await storage.removeItem(toUnstorageKey(key));\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n // unstorage's getKeys takes a base and returns matching keys with `:`\n // separators; convert them back so callers get their original `/` keys.\n // unstorage treats the base as a namespace (`aud:x` lists `aud:x:*` only), while the\n // contract is a plain string prefix: list from the last `/` boundary, then filter.\n const base = prefix.slice(0, prefix.lastIndexOf(\"/\") + 1);\n const keys = await storage.getKeys(toUnstorageKey(base));\n return keys.map(fromUnstorageKey).filter((key) => key.startsWith(prefix));\n },\n } satisfies AuditStorage;\n}\n"],"mappings":";AAkCA,MAAM,UAAkC;CAAE,KAAK;CAAO,KAAK;CAAO,MAAM;CAAO,KAAK;AAAM;AAC1F,MAAM,YAAoC;CAAE,OAAO;CAAK,OAAO;CAAK,OAAO;CAAM,OAAO;AAAI;;AAG5F,MAAM,kBAAkB,QAAwB,IAAI,QAAQ,aAAa,OAAO,QAAQ,GAAI;;AAG5F,MAAM,oBAAoB,QACxB,IAAI,QAAQ,MAAM,GAAG,EAAE,QAAQ,oBAAoB,MAAM,UAAU,EAAG;;;;;;;;;;;;;;;;;AAkBxE,SAAgB,uBAAuB,SAAgD;CACrF,MAAM,EAAE,YAAY;CAEpB,OAAO;EACL,MAAM,QAAW,KAAgC;GAC/C,MAAM,QAAQ,MAAM,QAAQ,QAAW,eAAe,GAAG,CAAC;GAC1D,OAAO,UAAU,KAAA,IAAY,OAAO;EACtC;EAEA,MAAM,QAAW,KAAa,OAAyB;GAErD,MAAM,QAAQ,QAAQ,eAAe,GAAG,GAAG,KAAuB;EACpE;EAEA,MAAM,WAAW,KAA4B;GAC3C,MAAM,QAAQ,WAAW,eAAe,GAAG,CAAC;EAC9C;EAEA,MAAM,QAAQ,QAAmC;GAK/C,MAAM,OAAO,OAAO,MAAM,GAAG,OAAO,YAAY,GAAG,IAAI,CAAC;GAExD,QAAO,MADY,QAAQ,QAAQ,eAAe,IAAI,CAAC,GAC3C,IAAI,gBAAgB,EAAE,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;EAC1E;CACF;AACF"}
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import { f as keysFromJwks, y as verifyChain } from "./integrity-kfY2DNAi.mjs";
|
|
2
|
+
//#region src/export.ts
|
|
3
|
+
/** The MIME type of each format. */
|
|
4
|
+
const EXPORT_CONTENT_TYPES = {
|
|
5
|
+
csv: "text/csv; charset=utf-8",
|
|
6
|
+
json: "application/json; charset=utf-8",
|
|
7
|
+
jsonl: "application/x-ndjson; charset=utf-8",
|
|
8
|
+
bundle: "application/x-ndjson; charset=utf-8"
|
|
9
|
+
};
|
|
10
|
+
/** CSV columns, in order. */
|
|
11
|
+
const CSV_COLUMNS = [
|
|
12
|
+
"id",
|
|
13
|
+
"tenant",
|
|
14
|
+
"seq",
|
|
15
|
+
"occurred_at",
|
|
16
|
+
"recorded_at",
|
|
17
|
+
"action",
|
|
18
|
+
"outcome",
|
|
19
|
+
"actor_id",
|
|
20
|
+
"actor_type",
|
|
21
|
+
"actor_name",
|
|
22
|
+
"actor_email",
|
|
23
|
+
"targets",
|
|
24
|
+
"ip",
|
|
25
|
+
"user_agent",
|
|
26
|
+
"request_id",
|
|
27
|
+
"description",
|
|
28
|
+
"metadata",
|
|
29
|
+
"hash"
|
|
30
|
+
];
|
|
31
|
+
/** Quote a CSV cell (RFC 4180) and neutralize spreadsheet formulas. */
|
|
32
|
+
function csvCell(value) {
|
|
33
|
+
if (value === void 0 || value === null) return "";
|
|
34
|
+
let s = typeof value === "string" ? value : JSON.stringify(value);
|
|
35
|
+
if (/^[=+\-@\t\r]/.test(s)) s = `'${s}`;
|
|
36
|
+
return /[",\n\r]/.test(s) ? `"${s.replace(/"/g, "\"\"")}"` : s;
|
|
37
|
+
}
|
|
38
|
+
/** One event as a CSV row. */
|
|
39
|
+
function eventToCsvRow(e) {
|
|
40
|
+
const ctx = e.context ?? {};
|
|
41
|
+
return [
|
|
42
|
+
e.id,
|
|
43
|
+
e.tenant,
|
|
44
|
+
e.seq,
|
|
45
|
+
e.occurredAt,
|
|
46
|
+
e.recordedAt,
|
|
47
|
+
e.action,
|
|
48
|
+
e.outcome,
|
|
49
|
+
e.actor.id,
|
|
50
|
+
e.actor.type ?? "user",
|
|
51
|
+
e.actor.name,
|
|
52
|
+
e.actor.email,
|
|
53
|
+
e.targets.length ? e.targets : "",
|
|
54
|
+
ctx.ip,
|
|
55
|
+
ctx.userAgent,
|
|
56
|
+
ctx.requestId,
|
|
57
|
+
e.description,
|
|
58
|
+
Object.keys(e.metadata ?? {}).length ? e.metadata : "",
|
|
59
|
+
e.integrity.hash
|
|
60
|
+
].map(csvCell).join(",");
|
|
61
|
+
}
|
|
62
|
+
const encoder = new TextEncoder();
|
|
63
|
+
async function* queryPages(core, query, max) {
|
|
64
|
+
let cursor = query.cursor;
|
|
65
|
+
let sent = 0;
|
|
66
|
+
for (;;) {
|
|
67
|
+
const page = await core.query({
|
|
68
|
+
...query,
|
|
69
|
+
limit: 500,
|
|
70
|
+
...cursor ? { cursor } : {}
|
|
71
|
+
});
|
|
72
|
+
for (const e of page.items) {
|
|
73
|
+
if (sent >= max) return;
|
|
74
|
+
sent++;
|
|
75
|
+
yield e;
|
|
76
|
+
}
|
|
77
|
+
if (!page.pageInfo.hasNextPage || !page.pageInfo.endCursor) return;
|
|
78
|
+
cursor = page.pageInfo.endCursor;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
async function* bundleLines(core, tenant, max) {
|
|
82
|
+
const head = await core.head(tenant);
|
|
83
|
+
const fromSeq = head.baseSeq ?? 1;
|
|
84
|
+
const header = {
|
|
85
|
+
type: "header",
|
|
86
|
+
format: "xtandard-audit-bundle",
|
|
87
|
+
v: 1,
|
|
88
|
+
tenant,
|
|
89
|
+
exportedAt: new Date(core.options.now()).toISOString(),
|
|
90
|
+
fromSeq: head.seq >= fromSeq ? fromSeq : null,
|
|
91
|
+
toSeq: head.seq >= fromSeq ? Math.min(head.seq, fromSeq + max - 1) : null,
|
|
92
|
+
...head.baseHash ? { baseHash: head.baseHash } : {}
|
|
93
|
+
};
|
|
94
|
+
yield JSON.stringify(header);
|
|
95
|
+
let after = fromSeq - 1;
|
|
96
|
+
const last = header.toSeq ?? 0;
|
|
97
|
+
while (after < last) {
|
|
98
|
+
const page = await core.eventsBySeq(tenant, {
|
|
99
|
+
afterSeq: after,
|
|
100
|
+
limit: 500
|
|
101
|
+
});
|
|
102
|
+
if (page.length === 0) break;
|
|
103
|
+
for (const e of page) if (e.seq <= last) yield JSON.stringify({
|
|
104
|
+
type: "event",
|
|
105
|
+
...e
|
|
106
|
+
});
|
|
107
|
+
after = page[page.length - 1].seq;
|
|
108
|
+
}
|
|
109
|
+
for (const cp of await core.listCheckpoints(tenant)) yield JSON.stringify({
|
|
110
|
+
type: "checkpoint",
|
|
111
|
+
...cp
|
|
112
|
+
});
|
|
113
|
+
yield JSON.stringify({
|
|
114
|
+
type: "jwks",
|
|
115
|
+
...await core.jwks()
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Stream a query (or, for `"bundle"`, a tenant's whole retained chain) in the
|
|
120
|
+
* given format. Requires `query.tenant` for every format (exports are always
|
|
121
|
+
* per tenant).
|
|
122
|
+
*
|
|
123
|
+
* @example
|
|
124
|
+
* ```ts
|
|
125
|
+
* import { exportEvents } from "@xtandard/audit";
|
|
126
|
+
*
|
|
127
|
+
* const stream = await exportEvents(audit, { tenant: "acme", from: "2026-01-01" }, { format: "csv" });
|
|
128
|
+
* return new Response(stream, { headers: { "content-type": "text/csv" } });
|
|
129
|
+
* ```
|
|
130
|
+
*/
|
|
131
|
+
async function exportEvents(core, query, options) {
|
|
132
|
+
const tenant = query.tenant;
|
|
133
|
+
if (!tenant) throw new TypeError("exportEvents requires query.tenant");
|
|
134
|
+
const anyCore = core;
|
|
135
|
+
const max = options.maxEvents ?? 1e5;
|
|
136
|
+
await core.noteExport(tenant, query, options.format, options.actor !== void 0 ? { actor: options.actor } : {});
|
|
137
|
+
async function* lines() {
|
|
138
|
+
switch (options.format) {
|
|
139
|
+
case "csv":
|
|
140
|
+
yield CSV_COLUMNS.join(",") + "\n";
|
|
141
|
+
for await (const e of queryPages(anyCore, query, max)) yield eventToCsvRow(e) + "\n";
|
|
142
|
+
return;
|
|
143
|
+
case "jsonl":
|
|
144
|
+
for await (const e of queryPages(anyCore, query, max)) yield JSON.stringify(e) + "\n";
|
|
145
|
+
return;
|
|
146
|
+
case "json": {
|
|
147
|
+
yield "[";
|
|
148
|
+
let first = true;
|
|
149
|
+
for await (const e of queryPages(anyCore, query, max)) {
|
|
150
|
+
yield (first ? "\n" : ",\n") + JSON.stringify(e);
|
|
151
|
+
first = false;
|
|
152
|
+
}
|
|
153
|
+
yield "\n]\n";
|
|
154
|
+
return;
|
|
155
|
+
}
|
|
156
|
+
case "bundle":
|
|
157
|
+
for await (const line of bundleLines(anyCore, tenant, max)) yield line + "\n";
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
const iterator = lines();
|
|
162
|
+
return new ReadableStream({
|
|
163
|
+
async pull(controller) {
|
|
164
|
+
const { value, done } = await iterator.next();
|
|
165
|
+
if (done) controller.close();
|
|
166
|
+
else controller.enqueue(encoder.encode(value));
|
|
167
|
+
},
|
|
168
|
+
async cancel() {
|
|
169
|
+
await iterator.return(void 0);
|
|
170
|
+
}
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
/** Parse a bundle (JSONL text). Throws on a malformed bundle. */
|
|
174
|
+
function parseBundle(text) {
|
|
175
|
+
let header = null;
|
|
176
|
+
const events = [];
|
|
177
|
+
const checkpoints = [];
|
|
178
|
+
let jwks = null;
|
|
179
|
+
for (const [i, line] of text.split("\n").entries()) {
|
|
180
|
+
if (!line.trim()) continue;
|
|
181
|
+
let item;
|
|
182
|
+
try {
|
|
183
|
+
item = JSON.parse(line);
|
|
184
|
+
} catch {
|
|
185
|
+
throw new Error(`bundle line ${i + 1} is not JSON`);
|
|
186
|
+
}
|
|
187
|
+
const { type, ...rest } = item;
|
|
188
|
+
if (type === "header") header = item;
|
|
189
|
+
else if (type === "event") events.push(rest);
|
|
190
|
+
else if (type === "checkpoint") checkpoints.push(rest);
|
|
191
|
+
else if (type === "jwks") jwks = rest;
|
|
192
|
+
}
|
|
193
|
+
if (!header || header.format !== "xtandard-audit-bundle") throw new Error("not an xtandard-audit bundle (missing header line)");
|
|
194
|
+
return {
|
|
195
|
+
header,
|
|
196
|
+
events,
|
|
197
|
+
checkpoints,
|
|
198
|
+
jwks
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* Verify a bundle offline. Keys default to the bundle's own JWKS — pass
|
|
203
|
+
* `keys` (from a JWKS you obtained independently, e.g. the vendor's published
|
|
204
|
+
* keys) to not trust the file for them.
|
|
205
|
+
*/
|
|
206
|
+
async function verifyBundle(text, options = {}) {
|
|
207
|
+
const bundle = parseBundle(text);
|
|
208
|
+
const keys = options.keys ?? (bundle.jwks ? await keysFromJwks(bundle.jwks) : void 0);
|
|
209
|
+
const report = await verifyChain(bundle.events, {
|
|
210
|
+
checkpoints: bundle.checkpoints,
|
|
211
|
+
...keys && keys.length ? { keys } : {}
|
|
212
|
+
});
|
|
213
|
+
const first = bundle.events.slice().sort((a, b) => a.seq - b.seq)[0];
|
|
214
|
+
if (first && first.seq > 1 && bundle.header.baseHash && first.integrity.prevHash !== bundle.header.baseHash) {
|
|
215
|
+
report.issues.push({
|
|
216
|
+
kind: "link-mismatch",
|
|
217
|
+
seq: first.seq,
|
|
218
|
+
eventId: first.id,
|
|
219
|
+
message: "first event does not link to the bundle's base hash"
|
|
220
|
+
});
|
|
221
|
+
report.ok = false;
|
|
222
|
+
}
|
|
223
|
+
if (bundle.header.toSeq !== null && report.toSeq !== bundle.header.toSeq) {
|
|
224
|
+
report.issues.push({
|
|
225
|
+
kind: "seq-gap",
|
|
226
|
+
seq: (report.toSeq ?? 0) + 1,
|
|
227
|
+
message: `bundle declares events through seq ${bundle.header.toSeq} but ends at ${report.toSeq}`
|
|
228
|
+
});
|
|
229
|
+
report.ok = false;
|
|
230
|
+
}
|
|
231
|
+
return {
|
|
232
|
+
...report,
|
|
233
|
+
bundle: bundle.header
|
|
234
|
+
};
|
|
235
|
+
}
|
|
236
|
+
//#endregion
|
|
237
|
+
export { exportEvents as a, eventToCsvRow as i, EXPORT_CONTENT_TYPES as n, parseBundle as o, csvCell as r, verifyBundle as s, CSV_COLUMNS as t };
|
|
238
|
+
|
|
239
|
+
//# sourceMappingURL=export-B9S-JeYl.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"export-B9S-JeYl.mjs","names":[],"sources":["../src/export.ts"],"sourcesContent":["/**\n * Exports: CSV, JSON and JSONL streams of a query, plus the **verifiable\n * bundle** — a JSONL file carrying a tenant's contiguous events together with\n * the checkpoints and public keys needed to verify it offline (ADR 0004).\n *\n * Every export is noted through `core.noteExport` (the `events.export` before\n * hook can deny it; the export is self-audited into the tenant's log).\n *\n * @module\n */\n\nimport type { ActorOptions, AuditCore } from \"./core.ts\";\nimport {\n verifyChain,\n keysFromJwks,\n type AuditVerificationKey,\n type VerifyReport,\n} from \"./integrity.ts\";\nimport type { AuditCheckpoint, AuditEvent, AuditQuery } from \"./schema.ts\";\nimport type { ActionMap } from \"./standard-schema.ts\";\n\n/** Export formats. */\nexport type ExportFormat = \"csv\" | \"json\" | \"jsonl\" | \"bundle\";\n\n/** The MIME type of each format. */\nexport const EXPORT_CONTENT_TYPES: Record<ExportFormat, string> = {\n csv: \"text/csv; charset=utf-8\",\n json: \"application/json; charset=utf-8\",\n jsonl: \"application/x-ndjson; charset=utf-8\",\n bundle: \"application/x-ndjson; charset=utf-8\",\n};\n\n/** CSV columns, in order. */\nexport const CSV_COLUMNS = [\n \"id\",\n \"tenant\",\n \"seq\",\n \"occurred_at\",\n \"recorded_at\",\n \"action\",\n \"outcome\",\n \"actor_id\",\n \"actor_type\",\n \"actor_name\",\n \"actor_email\",\n \"targets\",\n \"ip\",\n \"user_agent\",\n \"request_id\",\n \"description\",\n \"metadata\",\n \"hash\",\n] as const;\n\n/** Quote a CSV cell (RFC 4180) and neutralize spreadsheet formulas. */\nexport function csvCell(value: unknown): string {\n if (value === undefined || value === null) return \"\";\n let s = typeof value === \"string\" ? value : JSON.stringify(value);\n // CSV injection: a leading = + - @ (or tab/CR) is evaluated by spreadsheets.\n if (/^[=+\\-@\\t\\r]/.test(s)) s = `'${s}`;\n return /[\",\\n\\r]/.test(s) ? `\"${s.replace(/\"/g, '\"\"')}\"` : s;\n}\n\n/** One event as a CSV row. */\nexport function eventToCsvRow(e: AuditEvent): string {\n const ctx = e.context ?? {};\n return [\n e.id,\n e.tenant,\n e.seq,\n e.occurredAt,\n e.recordedAt,\n e.action,\n e.outcome,\n e.actor.id,\n e.actor.type ?? \"user\",\n e.actor.name,\n e.actor.email,\n e.targets.length ? e.targets : \"\",\n ctx.ip,\n ctx.userAgent,\n ctx.requestId,\n e.description,\n Object.keys(e.metadata ?? {}).length ? e.metadata : \"\",\n e.integrity.hash,\n ]\n .map(csvCell)\n .join(\",\");\n}\n\n/** The first line of a bundle. */\nexport interface BundleHeader {\n type: \"header\";\n format: \"xtandard-audit-bundle\";\n v: 1;\n tenant: string;\n exportedAt: string;\n fromSeq: number | null;\n toSeq: number | null;\n /** `prevHash` the first event must carry when it is not seq 1 (the prune base). */\n baseHash?: string;\n}\n\n/** A parsed bundle. */\nexport interface ParsedBundle {\n header: BundleHeader;\n events: AuditEvent[];\n checkpoints: AuditCheckpoint[];\n jwks: { keys: JsonWebKey[] } | null;\n}\n\n/** Options for {@link exportEvents}. */\nexport interface ExportOptions extends ActorOptions {\n format: ExportFormat;\n /** Max events exported. Default 100 000. */\n maxEvents?: number;\n}\n\nconst encoder = new TextEncoder();\n\nasync function* queryPages(core: AuditCore<ActionMap>, query: AuditQuery, max: number) {\n let cursor = query.cursor;\n let sent = 0;\n for (;;) {\n const page = await core.query({ ...query, limit: 500, ...(cursor ? { cursor } : {}) });\n for (const e of page.items) {\n if (sent >= max) return;\n sent++;\n yield e;\n }\n if (!page.pageInfo.hasNextPage || !page.pageInfo.endCursor) return;\n cursor = page.pageInfo.endCursor;\n }\n}\n\nasync function* bundleLines(core: AuditCore<ActionMap>, tenant: string, max: number) {\n const head = await core.head(tenant);\n const fromSeq = head.baseSeq ?? 1;\n const header: BundleHeader = {\n type: \"header\",\n format: \"xtandard-audit-bundle\",\n v: 1,\n tenant,\n exportedAt: new Date(core.options.now()).toISOString(),\n fromSeq: head.seq >= fromSeq ? fromSeq : null,\n toSeq: head.seq >= fromSeq ? Math.min(head.seq, fromSeq + max - 1) : null,\n ...(head.baseHash ? { baseHash: head.baseHash } : {}),\n };\n yield JSON.stringify(header);\n let after = fromSeq - 1;\n const last = header.toSeq ?? 0;\n while (after < last) {\n const page = await core.eventsBySeq(tenant, { afterSeq: after, limit: 500 });\n if (page.length === 0) break;\n for (const e of page) if (e.seq <= last) yield JSON.stringify({ type: \"event\", ...e });\n after = page[page.length - 1]!.seq;\n }\n for (const cp of await core.listCheckpoints(tenant)) {\n yield JSON.stringify({ type: \"checkpoint\", ...cp });\n }\n yield JSON.stringify({ type: \"jwks\", ...(await core.jwks()) });\n}\n\n/**\n * Stream a query (or, for `\"bundle\"`, a tenant's whole retained chain) in the\n * given format. Requires `query.tenant` for every format (exports are always\n * per tenant).\n *\n * @example\n * ```ts\n * import { exportEvents } from \"@xtandard/audit\";\n *\n * const stream = await exportEvents(audit, { tenant: \"acme\", from: \"2026-01-01\" }, { format: \"csv\" });\n * return new Response(stream, { headers: { \"content-type\": \"text/csv\" } });\n * ```\n */\nexport async function exportEvents<A extends ActionMap>(\n core: AuditCore<A>,\n query: AuditQuery,\n options: ExportOptions,\n): Promise<ReadableStream<Uint8Array>> {\n const tenant = query.tenant;\n if (!tenant) throw new TypeError(\"exportEvents requires query.tenant\");\n const anyCore = core as unknown as AuditCore<ActionMap>;\n const max = options.maxEvents ?? 100_000;\n await core.noteExport(\n tenant,\n query,\n options.format,\n options.actor !== undefined ? { actor: options.actor } : {},\n );\n\n async function* lines(): AsyncGenerator<string> {\n switch (options.format) {\n case \"csv\":\n yield CSV_COLUMNS.join(\",\") + \"\\n\";\n for await (const e of queryPages(anyCore, query, max)) yield eventToCsvRow(e) + \"\\n\";\n return;\n case \"jsonl\":\n for await (const e of queryPages(anyCore, query, max)) yield JSON.stringify(e) + \"\\n\";\n return;\n case \"json\": {\n yield \"[\";\n let first = true;\n for await (const e of queryPages(anyCore, query, max)) {\n yield (first ? \"\\n\" : \",\\n\") + JSON.stringify(e);\n first = false;\n }\n yield \"\\n]\\n\";\n return;\n }\n case \"bundle\":\n for await (const line of bundleLines(anyCore, tenant!, max)) yield line + \"\\n\";\n return;\n }\n }\n\n const iterator = lines();\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n const { value, done } = await iterator.next();\n if (done) controller.close();\n else controller.enqueue(encoder.encode(value));\n },\n async cancel() {\n await iterator.return(undefined);\n },\n });\n}\n\n/** Parse a bundle (JSONL text). Throws on a malformed bundle. */\nexport function parseBundle(text: string): ParsedBundle {\n let header: BundleHeader | null = null;\n const events: AuditEvent[] = [];\n const checkpoints: AuditCheckpoint[] = [];\n let jwks: ParsedBundle[\"jwks\"] = null;\n for (const [i, line] of text.split(\"\\n\").entries()) {\n if (!line.trim()) continue;\n let item: { type?: string } & Record<string, unknown>;\n try {\n item = JSON.parse(line);\n } catch {\n throw new Error(`bundle line ${i + 1} is not JSON`);\n }\n const { type, ...rest } = item;\n if (type === \"header\") header = item as unknown as BundleHeader;\n else if (type === \"event\") events.push(rest as unknown as AuditEvent);\n else if (type === \"checkpoint\") checkpoints.push(rest as unknown as AuditCheckpoint);\n else if (type === \"jwks\") jwks = rest as unknown as { keys: JsonWebKey[] };\n }\n if (!header || header.format !== \"xtandard-audit-bundle\") {\n throw new Error(\"not an xtandard-audit bundle (missing header line)\");\n }\n return { header, events, checkpoints, jwks };\n}\n\n/**\n * Verify a bundle offline. Keys default to the bundle's own JWKS — pass\n * `keys` (from a JWKS you obtained independently, e.g. the vendor's published\n * keys) to not trust the file for them.\n */\nexport async function verifyBundle(\n text: string,\n options: { keys?: AuditVerificationKey[] } = {},\n): Promise<VerifyReport & { bundle: BundleHeader }> {\n const bundle = parseBundle(text);\n const keys = options.keys ?? (bundle.jwks ? await keysFromJwks(bundle.jwks as never) : undefined);\n const report = await verifyChain(bundle.events, {\n checkpoints: bundle.checkpoints,\n ...(keys && keys.length ? { keys } : {}),\n });\n const first = bundle.events.slice().sort((a, b) => a.seq - b.seq)[0];\n if (\n first &&\n first.seq > 1 &&\n bundle.header.baseHash &&\n first.integrity.prevHash !== bundle.header.baseHash\n ) {\n report.issues.push({\n kind: \"link-mismatch\",\n seq: first.seq,\n eventId: first.id,\n message: \"first event does not link to the bundle's base hash\",\n });\n report.ok = false;\n }\n if (bundle.header.toSeq !== null && report.toSeq !== bundle.header.toSeq) {\n report.issues.push({\n kind: \"seq-gap\",\n seq: (report.toSeq ?? 0) + 1,\n message: `bundle declares events through seq ${bundle.header.toSeq} but ends at ${report.toSeq}`,\n });\n report.ok = false;\n }\n return { ...report, bundle: bundle.header };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { f as AuditQuery, i as AuditCheckpoint, s as AuditEvent } from "./schema-DmU7Wp0F.mjs";
|
|
2
|
+
import { E as ActionMap, N as AuditVerificationKey, R as VerifyReport, n as AuditCore, t as ActorOptions } from "./core-KtEHRScZ.mjs";
|
|
3
|
+
|
|
4
|
+
//#region src/export.d.ts
|
|
5
|
+
/** Export formats. */
|
|
6
|
+
type ExportFormat = "csv" | "json" | "jsonl" | "bundle";
|
|
7
|
+
/** The MIME type of each format. */
|
|
8
|
+
declare const EXPORT_CONTENT_TYPES: Record<ExportFormat, string>;
|
|
9
|
+
/** CSV columns, in order. */
|
|
10
|
+
declare const CSV_COLUMNS: readonly ["id", "tenant", "seq", "occurred_at", "recorded_at", "action", "outcome", "actor_id", "actor_type", "actor_name", "actor_email", "targets", "ip", "user_agent", "request_id", "description", "metadata", "hash"];
|
|
11
|
+
/** Quote a CSV cell (RFC 4180) and neutralize spreadsheet formulas. */
|
|
12
|
+
declare function csvCell(value: unknown): string;
|
|
13
|
+
/** One event as a CSV row. */
|
|
14
|
+
declare function eventToCsvRow(e: AuditEvent): string;
|
|
15
|
+
/** The first line of a bundle. */
|
|
16
|
+
interface BundleHeader {
|
|
17
|
+
type: "header";
|
|
18
|
+
format: "xtandard-audit-bundle";
|
|
19
|
+
v: 1;
|
|
20
|
+
tenant: string;
|
|
21
|
+
exportedAt: string;
|
|
22
|
+
fromSeq: number | null;
|
|
23
|
+
toSeq: number | null;
|
|
24
|
+
/** `prevHash` the first event must carry when it is not seq 1 (the prune base). */
|
|
25
|
+
baseHash?: string;
|
|
26
|
+
}
|
|
27
|
+
/** A parsed bundle. */
|
|
28
|
+
interface ParsedBundle {
|
|
29
|
+
header: BundleHeader;
|
|
30
|
+
events: AuditEvent[];
|
|
31
|
+
checkpoints: AuditCheckpoint[];
|
|
32
|
+
jwks: {
|
|
33
|
+
keys: JsonWebKey[];
|
|
34
|
+
} | null;
|
|
35
|
+
}
|
|
36
|
+
/** Options for {@link exportEvents}. */
|
|
37
|
+
interface ExportOptions extends ActorOptions {
|
|
38
|
+
format: ExportFormat;
|
|
39
|
+
/** Max events exported. Default 100 000. */
|
|
40
|
+
maxEvents?: number;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Stream a query (or, for `"bundle"`, a tenant's whole retained chain) in the
|
|
44
|
+
* given format. Requires `query.tenant` for every format (exports are always
|
|
45
|
+
* per tenant).
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* ```ts
|
|
49
|
+
* import { exportEvents } from "@xtandard/audit";
|
|
50
|
+
*
|
|
51
|
+
* const stream = await exportEvents(audit, { tenant: "acme", from: "2026-01-01" }, { format: "csv" });
|
|
52
|
+
* return new Response(stream, { headers: { "content-type": "text/csv" } });
|
|
53
|
+
* ```
|
|
54
|
+
*/
|
|
55
|
+
declare function exportEvents<A extends ActionMap>(core: AuditCore<A>, query: AuditQuery, options: ExportOptions): Promise<ReadableStream<Uint8Array>>;
|
|
56
|
+
/** Parse a bundle (JSONL text). Throws on a malformed bundle. */
|
|
57
|
+
declare function parseBundle(text: string): ParsedBundle;
|
|
58
|
+
/**
|
|
59
|
+
* Verify a bundle offline. Keys default to the bundle's own JWKS — pass
|
|
60
|
+
* `keys` (from a JWKS you obtained independently, e.g. the vendor's published
|
|
61
|
+
* keys) to not trust the file for them.
|
|
62
|
+
*/
|
|
63
|
+
declare function verifyBundle(text: string, options?: {
|
|
64
|
+
keys?: AuditVerificationKey[];
|
|
65
|
+
}): Promise<VerifyReport & {
|
|
66
|
+
bundle: BundleHeader;
|
|
67
|
+
}>;
|
|
68
|
+
//#endregion
|
|
69
|
+
export { ExportOptions as a, eventToCsvRow as c, verifyBundle as d, ExportFormat as i, exportEvents as l, CSV_COLUMNS as n, ParsedBundle as o, EXPORT_CONTENT_TYPES as r, csvCell as s, BundleHeader as t, parseBundle as u };
|
|
70
|
+
//# sourceMappingURL=export-BZq0KCCn.d.mts.map
|