@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,66 @@
|
|
|
1
|
+
import { i as EventLogStorage } from "./contract-CWJSYoJl.cjs";
|
|
2
|
+
|
|
3
|
+
//#region src/storage/postgres.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and
|
|
6
|
+
* `@electric-sql/pglite`'s `PGlite` satisfy this shape.
|
|
7
|
+
*/
|
|
8
|
+
interface SqlClient {
|
|
9
|
+
query(text: string, params?: unknown[]): Promise<{
|
|
10
|
+
rows: Array<Record<string, unknown>>;
|
|
11
|
+
}>;
|
|
12
|
+
}
|
|
13
|
+
/** Options for {@link createPostgresStorage}. */
|
|
14
|
+
interface PostgresStorageOptions {
|
|
15
|
+
/**
|
|
16
|
+
* A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.
|
|
17
|
+
* Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.
|
|
18
|
+
*/
|
|
19
|
+
client?: SqlClient;
|
|
20
|
+
/**
|
|
21
|
+
* Connection string used to lazily create a `pg` `Pool` (via dynamic import)
|
|
22
|
+
* when no `client` is supplied.
|
|
23
|
+
*/
|
|
24
|
+
connectionString?: string;
|
|
25
|
+
/** Alias for {@link PostgresStorageOptions.connectionString}. */
|
|
26
|
+
url?: string;
|
|
27
|
+
/**
|
|
28
|
+
* KV table name (default `"xtandard_audit"`); the event log uses
|
|
29
|
+
* `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.
|
|
30
|
+
*/
|
|
31
|
+
table?: string;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* A storage backed by Postgres with the native
|
|
35
|
+
* {@link EventLogStorage} capability, plus a `close()` method that ends the
|
|
36
|
+
* underlying pool — but only the one this adapter created. A client you passed
|
|
37
|
+
* in is left for you to manage.
|
|
38
|
+
*/
|
|
39
|
+
interface PostgresAuditStorage extends EventLogStorage {
|
|
40
|
+
/** End the underlying pool if this adapter created it. No-op otherwise. */
|
|
41
|
+
close(): Promise<void>;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
|
|
45
|
+
* lazily on first use; connection (when using `connectionString`/`url`) is also
|
|
46
|
+
* lazy — the `pg` `Pool` is imported and constructed on the first operation and
|
|
47
|
+
* reused thereafter.
|
|
48
|
+
*
|
|
49
|
+
* @example
|
|
50
|
+
* ```ts
|
|
51
|
+
* import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
|
|
52
|
+
*
|
|
53
|
+
* // Via connection string (lazy `pg` Pool):
|
|
54
|
+
* const storage = createPostgresStorage({
|
|
55
|
+
* connectionString: process.env.DATABASE_URL,
|
|
56
|
+
* });
|
|
57
|
+
*
|
|
58
|
+
* // Or with a pre-built pg Pool / PGlite client:
|
|
59
|
+
* // import { PGlite } from "@electric-sql/pglite";
|
|
60
|
+
* // const storage = createPostgresStorage({ client: new PGlite() });
|
|
61
|
+
* ```
|
|
62
|
+
*/
|
|
63
|
+
declare function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage;
|
|
64
|
+
//#endregion
|
|
65
|
+
export { PostgresAuditStorage, PostgresStorageOptions, SqlClient, createPostgresStorage };
|
|
66
|
+
//# sourceMappingURL=entry-storage-postgres.d.cts.map
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { i as EventLogStorage } from "./contract-BmwHIiMR.mjs";
|
|
2
|
+
|
|
3
|
+
//#region src/storage/postgres.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and
|
|
6
|
+
* `@electric-sql/pglite`'s `PGlite` satisfy this shape.
|
|
7
|
+
*/
|
|
8
|
+
interface SqlClient {
|
|
9
|
+
query(text: string, params?: unknown[]): Promise<{
|
|
10
|
+
rows: Array<Record<string, unknown>>;
|
|
11
|
+
}>;
|
|
12
|
+
}
|
|
13
|
+
/** Options for {@link createPostgresStorage}. */
|
|
14
|
+
interface PostgresStorageOptions {
|
|
15
|
+
/**
|
|
16
|
+
* A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.
|
|
17
|
+
* Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.
|
|
18
|
+
*/
|
|
19
|
+
client?: SqlClient;
|
|
20
|
+
/**
|
|
21
|
+
* Connection string used to lazily create a `pg` `Pool` (via dynamic import)
|
|
22
|
+
* when no `client` is supplied.
|
|
23
|
+
*/
|
|
24
|
+
connectionString?: string;
|
|
25
|
+
/** Alias for {@link PostgresStorageOptions.connectionString}. */
|
|
26
|
+
url?: string;
|
|
27
|
+
/**
|
|
28
|
+
* KV table name (default `"xtandard_audit"`); the event log uses
|
|
29
|
+
* `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.
|
|
30
|
+
*/
|
|
31
|
+
table?: string;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* A storage backed by Postgres with the native
|
|
35
|
+
* {@link EventLogStorage} capability, plus a `close()` method that ends the
|
|
36
|
+
* underlying pool — but only the one this adapter created. A client you passed
|
|
37
|
+
* in is left for you to manage.
|
|
38
|
+
*/
|
|
39
|
+
interface PostgresAuditStorage extends EventLogStorage {
|
|
40
|
+
/** End the underlying pool if this adapter created it. No-op otherwise. */
|
|
41
|
+
close(): Promise<void>;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
|
|
45
|
+
* lazily on first use; connection (when using `connectionString`/`url`) is also
|
|
46
|
+
* lazy — the `pg` `Pool` is imported and constructed on the first operation and
|
|
47
|
+
* reused thereafter.
|
|
48
|
+
*
|
|
49
|
+
* @example
|
|
50
|
+
* ```ts
|
|
51
|
+
* import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
|
|
52
|
+
*
|
|
53
|
+
* // Via connection string (lazy `pg` Pool):
|
|
54
|
+
* const storage = createPostgresStorage({
|
|
55
|
+
* connectionString: process.env.DATABASE_URL,
|
|
56
|
+
* });
|
|
57
|
+
*
|
|
58
|
+
* // Or with a pre-built pg Pool / PGlite client:
|
|
59
|
+
* // import { PGlite } from "@electric-sql/pglite";
|
|
60
|
+
* // const storage = createPostgresStorage({ client: new PGlite() });
|
|
61
|
+
* ```
|
|
62
|
+
*/
|
|
63
|
+
declare function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage;
|
|
64
|
+
//#endregion
|
|
65
|
+
export { PostgresAuditStorage, PostgresStorageOptions, SqlClient, createPostgresStorage };
|
|
66
|
+
//# sourceMappingURL=entry-storage-postgres.d.mts.map
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
import { o as requirePeer, t as ChainConflictError } from "./contract-isM9SjjQ.mjs";
|
|
2
|
+
import { c as eventTableNames, d as parseEvent, f as toQueryResult, l as eventTargets, n as assertSafeIdentifier, o as eventColumns, r as compileEventQuery, s as eventLogDdl, t as assertContiguous, u as isWriteConflict } from "./sql-COjPyn3F.mjs";
|
|
3
|
+
//#region src/storage/postgres.ts
|
|
4
|
+
/**
|
|
5
|
+
* Postgres storage adapter: a key/value table (`key text PRIMARY KEY, value
|
|
6
|
+
* jsonb`) for control data plus the **native event log** (ADR 0005) in
|
|
7
|
+
* `{table}_events` / `{table}_event_targets` (see {@link ./sql}). It works with
|
|
8
|
+
* any client exposing a `query(text, params?)` method that resolves to
|
|
9
|
+
* `{ rows }` — this covers [`pg`](https://github.com/brianc/node-postgres)
|
|
10
|
+
* (`Pool`/`Client`) and the in-process
|
|
11
|
+
* [`@electric-sql/pglite`](https://github.com/electric-sql/pglite) alike. You
|
|
12
|
+
* can pass a pre-built `client`, or a `connectionString`/`url` to lazily create
|
|
13
|
+
* a `pg` `Pool` on first use.
|
|
14
|
+
*
|
|
15
|
+
* The tables are created on demand (`CREATE TABLE IF NOT EXISTS`) the first
|
|
16
|
+
* time any operation runs, guarded by a single promise so concurrent callers
|
|
17
|
+
* only issue the DDL once. Values are stored as `jsonb`; both `pg` and `pglite`
|
|
18
|
+
* return `jsonb` already parsed to JS, but a string is JSON-parsed defensively
|
|
19
|
+
* so either driver works.
|
|
20
|
+
*
|
|
21
|
+
* Every event-log write is a **single statement** (data-modifying CTEs), so it
|
|
22
|
+
* is atomic without a transaction — which keeps the adapter correct on a `pg`
|
|
23
|
+
* `Pool`, where consecutive queries may run on different connections. An
|
|
24
|
+
* append inserts only when the tenant's max seq is the expected one, and the
|
|
25
|
+
* `(tenant, seq)` primary key turns a concurrent writer's race into a
|
|
26
|
+
* {@link ChainConflictError}.
|
|
27
|
+
*
|
|
28
|
+
* @module
|
|
29
|
+
*/
|
|
30
|
+
/**
|
|
31
|
+
* Escape LIKE wildcards (`%`, `_`) and the escape char itself in a literal
|
|
32
|
+
* prefix so `getKeys` matches the prefix verbatim. Paired with `ESCAPE '\'`.
|
|
33
|
+
*/
|
|
34
|
+
const escapeLike = (literal) => literal.replace(/[\\%_]/g, (c) => `\\${c}`);
|
|
35
|
+
/** `jsonb_to_recordset` column list for event rows. */
|
|
36
|
+
const EVENT_RECORD = `r(tenant text, seq bigint, id text, action text, occurred_at text,
|
|
37
|
+
recorded_at text, actor_id text, actor_type text, outcome text, search text, data jsonb)`;
|
|
38
|
+
const EVENT_COLUMNS = `tenant, seq, id, action, occurred_at, recorded_at, actor_id, actor_type,
|
|
39
|
+
outcome, search, data`;
|
|
40
|
+
/**
|
|
41
|
+
* Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created
|
|
42
|
+
* lazily on first use; connection (when using `connectionString`/`url`) is also
|
|
43
|
+
* lazy — the `pg` `Pool` is imported and constructed on the first operation and
|
|
44
|
+
* reused thereafter.
|
|
45
|
+
*
|
|
46
|
+
* @example
|
|
47
|
+
* ```ts
|
|
48
|
+
* import { createPostgresStorage } from "@xtandard/audit/storage/postgres";
|
|
49
|
+
*
|
|
50
|
+
* // Via connection string (lazy `pg` Pool):
|
|
51
|
+
* const storage = createPostgresStorage({
|
|
52
|
+
* connectionString: process.env.DATABASE_URL,
|
|
53
|
+
* });
|
|
54
|
+
*
|
|
55
|
+
* // Or with a pre-built pg Pool / PGlite client:
|
|
56
|
+
* // import { PGlite } from "@electric-sql/pglite";
|
|
57
|
+
* // const storage = createPostgresStorage({ client: new PGlite() });
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
function createPostgresStorage(options) {
|
|
61
|
+
const table = assertSafeIdentifier(options.table ?? "xtandard_audit");
|
|
62
|
+
const names = eventTableNames(table);
|
|
63
|
+
const { events: ev, targets: tg } = names;
|
|
64
|
+
const connectionString = options.connectionString ?? options.url;
|
|
65
|
+
const ownsClient = !options.client;
|
|
66
|
+
let client = options.client;
|
|
67
|
+
let connecting;
|
|
68
|
+
let ensured;
|
|
69
|
+
/** Resolve a client, creating a `pg` `Pool` on first use when needed. */
|
|
70
|
+
async function getClient() {
|
|
71
|
+
if (client) return client;
|
|
72
|
+
connecting ??= (async () => {
|
|
73
|
+
let Pool;
|
|
74
|
+
try {
|
|
75
|
+
({Pool} = await import("pg"));
|
|
76
|
+
} catch {
|
|
77
|
+
requirePeer("pg", "storage/postgres");
|
|
78
|
+
}
|
|
79
|
+
client = new Pool({ connectionString });
|
|
80
|
+
return client;
|
|
81
|
+
})();
|
|
82
|
+
try {
|
|
83
|
+
return await connecting;
|
|
84
|
+
} finally {
|
|
85
|
+
connecting = void 0;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
/** Create the backing tables once, before the first operation. */
|
|
89
|
+
async function ensureTable() {
|
|
90
|
+
const c = await getClient();
|
|
91
|
+
ensured ??= (async () => {
|
|
92
|
+
await c.query(`CREATE TABLE IF NOT EXISTS ${table} (key text PRIMARY KEY, value jsonb NOT NULL)`);
|
|
93
|
+
for (const ddl of eventLogDdl("postgres", table)) await c.query(ddl);
|
|
94
|
+
})();
|
|
95
|
+
try {
|
|
96
|
+
await ensured;
|
|
97
|
+
} catch (err) {
|
|
98
|
+
ensured = void 0;
|
|
99
|
+
throw err;
|
|
100
|
+
}
|
|
101
|
+
return c;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Normalise a `jsonb` column value. Both `pg` and `pglite` typically return
|
|
105
|
+
* it already parsed, but parse a string defensively so either driver works.
|
|
106
|
+
*/
|
|
107
|
+
const parseValue = (value) => {
|
|
108
|
+
if (typeof value === "string") try {
|
|
109
|
+
return JSON.parse(value);
|
|
110
|
+
} catch {
|
|
111
|
+
return value;
|
|
112
|
+
}
|
|
113
|
+
return value;
|
|
114
|
+
};
|
|
115
|
+
const rows = async (text, params) => (await (await ensureTable()).query(text, params)).rows;
|
|
116
|
+
const one = async (text, params) => {
|
|
117
|
+
const [row] = await rows(text, params);
|
|
118
|
+
return row ? parseEvent(row.data) : null;
|
|
119
|
+
};
|
|
120
|
+
return {
|
|
121
|
+
async getItem(key) {
|
|
122
|
+
const [row] = await rows(`SELECT value FROM ${table} WHERE key = $1`, [key]);
|
|
123
|
+
if (row === void 0 || row.value === null || row.value === void 0) return null;
|
|
124
|
+
return parseValue(row.value);
|
|
125
|
+
},
|
|
126
|
+
async setItem(key, value) {
|
|
127
|
+
await rows(`INSERT INTO ${table} (key, value) VALUES ($1, $2::jsonb)
|
|
128
|
+
ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value`, [key, JSON.stringify(value)]);
|
|
129
|
+
},
|
|
130
|
+
async removeItem(key) {
|
|
131
|
+
await rows(`DELETE FROM ${table} WHERE key = $1`, [key]);
|
|
132
|
+
},
|
|
133
|
+
async getKeys(prefix) {
|
|
134
|
+
return (await rows(`SELECT key FROM ${table} WHERE key LIKE $1 ESCAPE '\\'`, [`${escapeLike(prefix)}%`])).map((row) => String(row.key)).filter((key) => key.startsWith(prefix));
|
|
135
|
+
},
|
|
136
|
+
async appendEvents(tenant, events, { expectedSeq }) {
|
|
137
|
+
if (events.length === 0) return;
|
|
138
|
+
assertContiguous(tenant, events, expectedSeq);
|
|
139
|
+
const eventRows = events.map((e) => {
|
|
140
|
+
const c = eventColumns(e);
|
|
141
|
+
return {
|
|
142
|
+
tenant: c.tenant,
|
|
143
|
+
seq: c.seq,
|
|
144
|
+
id: c.id,
|
|
145
|
+
action: c.action,
|
|
146
|
+
occurred_at: c.occurredAt,
|
|
147
|
+
recorded_at: c.recordedAt,
|
|
148
|
+
actor_id: c.actorId,
|
|
149
|
+
actor_type: c.actorType,
|
|
150
|
+
outcome: c.outcome,
|
|
151
|
+
search: c.search,
|
|
152
|
+
data: e
|
|
153
|
+
};
|
|
154
|
+
});
|
|
155
|
+
const targetRows = events.flatMap((e) => eventTargets(e).map((t) => ({
|
|
156
|
+
seq: e.seq,
|
|
157
|
+
type: t.type,
|
|
158
|
+
target_id: t.targetId
|
|
159
|
+
})));
|
|
160
|
+
let inserted;
|
|
161
|
+
try {
|
|
162
|
+
const [row] = await rows(`WITH head AS (
|
|
163
|
+
SELECT COALESCE(MAX(seq), 0) AS seq FROM ${ev} WHERE tenant = $1
|
|
164
|
+
), ok AS (
|
|
165
|
+
SELECT 1 FROM head WHERE head.seq = $2 OR head.seq = 0
|
|
166
|
+
), ins AS (
|
|
167
|
+
INSERT INTO ${ev} (${EVENT_COLUMNS})
|
|
168
|
+
SELECT ${EVENT_COLUMNS} FROM jsonb_to_recordset($3::jsonb) AS ${EVENT_RECORD}
|
|
169
|
+
WHERE EXISTS (SELECT 1 FROM ok)
|
|
170
|
+
RETURNING seq
|
|
171
|
+
), tgt AS (
|
|
172
|
+
INSERT INTO ${tg} (tenant, seq, type, target_id)
|
|
173
|
+
SELECT $1, r.seq, r.type, r.target_id
|
|
174
|
+
FROM jsonb_to_recordset($4::jsonb) AS r(seq bigint, type text, target_id text)
|
|
175
|
+
WHERE EXISTS (SELECT 1 FROM ok)
|
|
176
|
+
)
|
|
177
|
+
SELECT COUNT(*) AS n FROM ins`, [
|
|
178
|
+
tenant,
|
|
179
|
+
expectedSeq,
|
|
180
|
+
JSON.stringify(eventRows),
|
|
181
|
+
JSON.stringify(targetRows)
|
|
182
|
+
]);
|
|
183
|
+
inserted = Number(row?.n ?? 0);
|
|
184
|
+
} catch (err) {
|
|
185
|
+
if (isWriteConflict(err)) throw new ChainConflictError(tenant, expectedSeq);
|
|
186
|
+
throw err;
|
|
187
|
+
}
|
|
188
|
+
if (inserted !== events.length) throw new ChainConflictError(tenant, expectedSeq);
|
|
189
|
+
},
|
|
190
|
+
getEvent: (tenant, id) => one(`SELECT data FROM ${ev} WHERE tenant = $1 AND id = $2`, [tenant, id]),
|
|
191
|
+
lastEvent: (tenant) => one(`SELECT data FROM ${ev} WHERE tenant = $1 ORDER BY seq DESC LIMIT 1`, [tenant]),
|
|
192
|
+
async eventsBySeq(tenant, { afterSeq, limit }) {
|
|
193
|
+
return (await rows(`SELECT data FROM ${ev} WHERE tenant = $1 AND seq > $2 ORDER BY seq ASC LIMIT $3`, [
|
|
194
|
+
tenant,
|
|
195
|
+
afterSeq,
|
|
196
|
+
limit
|
|
197
|
+
])).map((r) => parseEvent(r.data));
|
|
198
|
+
},
|
|
199
|
+
async queryEvents(q) {
|
|
200
|
+
const { sql, args } = compileEventQuery("postgres", names, q);
|
|
201
|
+
return toQueryResult(await rows(sql, args), q.limit);
|
|
202
|
+
},
|
|
203
|
+
async replaceEvent(event) {
|
|
204
|
+
const c = eventColumns(event);
|
|
205
|
+
const targets = eventTargets(event).map((t) => ({
|
|
206
|
+
type: t.type,
|
|
207
|
+
target_id: t.targetId
|
|
208
|
+
}));
|
|
209
|
+
await rows(`WITH upd AS (
|
|
210
|
+
UPDATE ${ev} SET action = $4, occurred_at = $5, recorded_at = $6, actor_id = $7,
|
|
211
|
+
actor_type = $8, outcome = $9, search = $10, data = $11::jsonb
|
|
212
|
+
WHERE tenant = $1 AND seq = $2 AND id = $3
|
|
213
|
+
RETURNING tenant, seq
|
|
214
|
+
), del AS (
|
|
215
|
+
DELETE FROM ${tg} t USING upd WHERE t.tenant = upd.tenant AND t.seq = upd.seq
|
|
216
|
+
), ins AS (
|
|
217
|
+
INSERT INTO ${tg} (tenant, seq, type, target_id)
|
|
218
|
+
SELECT upd.tenant, upd.seq, r.type, r.target_id
|
|
219
|
+
FROM upd, jsonb_to_recordset($12::jsonb) AS r(type text, target_id text)
|
|
220
|
+
)
|
|
221
|
+
SELECT COUNT(*) AS n FROM upd`, [
|
|
222
|
+
c.tenant,
|
|
223
|
+
c.seq,
|
|
224
|
+
c.id,
|
|
225
|
+
c.action,
|
|
226
|
+
c.occurredAt,
|
|
227
|
+
c.recordedAt,
|
|
228
|
+
c.actorId,
|
|
229
|
+
c.actorType,
|
|
230
|
+
c.outcome,
|
|
231
|
+
c.search,
|
|
232
|
+
JSON.stringify(event),
|
|
233
|
+
JSON.stringify(targets)
|
|
234
|
+
]);
|
|
235
|
+
},
|
|
236
|
+
async deleteEventsThrough(tenant, throughSeq) {
|
|
237
|
+
const [row] = await rows(`WITH d AS (
|
|
238
|
+
DELETE FROM ${ev} WHERE tenant = $1 AND seq <= $2 RETURNING 1
|
|
239
|
+
), dt AS (
|
|
240
|
+
DELETE FROM ${tg} WHERE tenant = $1 AND seq <= $2
|
|
241
|
+
)
|
|
242
|
+
SELECT COUNT(*) AS n FROM d`, [tenant, throughSeq]);
|
|
243
|
+
return Number(row?.n ?? 0);
|
|
244
|
+
},
|
|
245
|
+
async countEvents(tenant) {
|
|
246
|
+
const [row] = tenant !== void 0 ? await rows(`SELECT COUNT(*) AS n FROM ${ev} WHERE tenant = $1`, [tenant]) : await rows(`SELECT COUNT(*) AS n FROM ${ev}`, []);
|
|
247
|
+
return Number(row?.n ?? 0);
|
|
248
|
+
},
|
|
249
|
+
async listEventTenants() {
|
|
250
|
+
return (await rows(`SELECT DISTINCT tenant FROM ${ev} ORDER BY tenant`, [])).map((r) => String(r.tenant));
|
|
251
|
+
},
|
|
252
|
+
async close() {
|
|
253
|
+
if (ownsClient && client?.end) await client.end();
|
|
254
|
+
}
|
|
255
|
+
};
|
|
256
|
+
}
|
|
257
|
+
//#endregion
|
|
258
|
+
export { createPostgresStorage };
|
|
259
|
+
|
|
260
|
+
//# sourceMappingURL=entry-storage-postgres.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entry-storage-postgres.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["/**\n * Postgres storage adapter: a key/value table (`key text PRIMARY KEY, value\n * jsonb`) for control data plus the **native event log** (ADR 0005) in\n * `{table}_events` / `{table}_event_targets` (see {@link ./sql}). It works with\n * any client exposing a `query(text, params?)` method that resolves to\n * `{ rows }` — this covers [`pg`](https://github.com/brianc/node-postgres)\n * (`Pool`/`Client`) and the in-process\n * [`@electric-sql/pglite`](https://github.com/electric-sql/pglite) alike. You\n * can pass a pre-built `client`, or a `connectionString`/`url` to lazily create\n * a `pg` `Pool` on first use.\n *\n * The tables are created on demand (`CREATE TABLE IF NOT EXISTS`) the first\n * time any operation runs, guarded by a single promise so concurrent callers\n * only issue the DDL once. Values are stored as `jsonb`; both `pg` and `pglite`\n * return `jsonb` already parsed to JS, but a string is JSON-parsed defensively\n * so either driver works.\n *\n * Every event-log write is a **single statement** (data-modifying CTEs), so it\n * is atomic without a transaction — which keeps the adapter correct on a `pg`\n * `Pool`, where consecutive queries may run on different connections. An\n * append inserts only when the tenant's max seq is the expected one, and the\n * `(tenant, seq)` primary key turns a concurrent writer's race into a\n * {@link ChainConflictError}.\n *\n * @module\n */\n\nimport { ChainConflictError, requirePeer } from \"./contract.ts\";\nimport type { EventLogStorage } from \"./contract.ts\";\nimport {\n assertContiguous,\n assertSafeIdentifier,\n compileEventQuery,\n eventColumns,\n eventLogDdl,\n eventTableNames,\n eventTargets,\n isWriteConflict,\n parseEvent,\n toQueryResult,\n} from \"./sql.ts\";\n\n/**\n * Minimal structural view of a SQL client. Both `pg`'s `Pool`/`Client` and\n * `@electric-sql/pglite`'s `PGlite` satisfy this shape.\n */\nexport interface SqlClient {\n query(text: string, params?: unknown[]): Promise<{ rows: Array<Record<string, unknown>> }>;\n}\n\n/** A client this adapter can also shut down (e.g. a `pg` `Pool`). */\ninterface ClosableSqlClient extends SqlClient {\n end?(): Promise<unknown>;\n}\n\n/** Options for {@link createPostgresStorage}. */\nexport interface PostgresStorageOptions {\n /**\n * A pre-built client exposing `query(text, params?) => Promise<{ rows }>`.\n * Both a `pg` `Pool`/`Client` and `@electric-sql/pglite` satisfy this.\n */\n client?: SqlClient;\n /**\n * Connection string used to lazily create a `pg` `Pool` (via dynamic import)\n * when no `client` is supplied.\n */\n connectionString?: string;\n /** Alias for {@link PostgresStorageOptions.connectionString}. */\n url?: string;\n /**\n * KV table name (default `\"xtandard_audit\"`); the event log uses\n * `{table}_events` and `{table}_event_targets`. Must be a safe SQL identifier.\n */\n table?: string;\n}\n\n/**\n * A storage backed by Postgres with the native\n * {@link EventLogStorage} capability, plus a `close()` method that ends the\n * underlying pool — but only the one this adapter created. A client you passed\n * in is left for you to manage.\n */\nexport interface PostgresAuditStorage extends EventLogStorage {\n /** End the underlying pool if this adapter created it. No-op otherwise. */\n close(): Promise<void>;\n}\n\n/**\n * Escape LIKE wildcards (`%`, `_`) and the escape char itself in a literal\n * prefix so `getKeys` matches the prefix verbatim. Paired with `ESCAPE '\\'`.\n */\nconst escapeLike = (literal: string): string => literal.replace(/[\\\\%_]/g, (c) => `\\\\${c}`);\n\n/** `jsonb_to_recordset` column list for event rows. */\nconst EVENT_RECORD = `r(tenant text, seq bigint, id text, action text, occurred_at text,\n recorded_at text, actor_id text, actor_type text, outcome text, search text, data jsonb)`;\nconst EVENT_COLUMNS = `tenant, seq, id, action, occurred_at, recorded_at, actor_id, actor_type,\n outcome, search, data`;\n\n/**\n * Create a Postgres-backed {@link PostgresAuditStorage}. The tables are created\n * lazily on first use; connection (when using `connectionString`/`url`) is also\n * lazy — the `pg` `Pool` is imported and constructed on the first operation and\n * reused thereafter.\n *\n * @example\n * ```ts\n * import { createPostgresStorage } from \"@xtandard/audit/storage/postgres\";\n *\n * // Via connection string (lazy `pg` Pool):\n * const storage = createPostgresStorage({\n * connectionString: process.env.DATABASE_URL,\n * });\n *\n * // Or with a pre-built pg Pool / PGlite client:\n * // import { PGlite } from \"@electric-sql/pglite\";\n * // const storage = createPostgresStorage({ client: new PGlite() });\n * ```\n */\nexport function createPostgresStorage(options: PostgresStorageOptions): PostgresAuditStorage {\n const table = assertSafeIdentifier(options.table ?? \"xtandard_audit\");\n const names = eventTableNames(table);\n const { events: ev, targets: tg } = names;\n const connectionString = options.connectionString ?? options.url;\n const ownsClient = !options.client;\n\n let client: ClosableSqlClient | undefined = options.client;\n let connecting: Promise<ClosableSqlClient> | undefined;\n let ensured: Promise<void> | undefined;\n\n /** Resolve a client, creating a `pg` `Pool` on first use when needed. */\n async function getClient(): Promise<ClosableSqlClient> {\n if (client) return client;\n connecting ??= (async () => {\n let Pool: new (config: { connectionString?: string }) => ClosableSqlClient;\n try {\n ({ Pool } = (await import(\"pg\")) as unknown as {\n Pool: new (config: { connectionString?: string }) => ClosableSqlClient;\n });\n } catch {\n requirePeer(\"pg\", \"storage/postgres\");\n }\n client = new Pool({ connectionString });\n return client;\n })();\n try {\n return await connecting;\n } finally {\n connecting = undefined;\n }\n }\n\n /** Create the backing tables once, before the first operation. */\n async function ensureTable(): Promise<ClosableSqlClient> {\n const c = await getClient();\n ensured ??= (async () => {\n await c.query(\n `CREATE TABLE IF NOT EXISTS ${table} (key text PRIMARY KEY, value jsonb NOT NULL)`,\n );\n for (const ddl of eventLogDdl(\"postgres\", table)) await c.query(ddl);\n })();\n try {\n await ensured;\n } catch (err) {\n ensured = undefined; // let a later call retry the DDL\n throw err;\n }\n return c;\n }\n\n /**\n * Normalise a `jsonb` column value. Both `pg` and `pglite` typically return\n * it already parsed, but parse a string defensively so either driver works.\n */\n const parseValue = <T>(value: unknown): T => {\n if (typeof value === \"string\") {\n try {\n return JSON.parse(value) as T;\n } catch {\n return value as T;\n }\n }\n return value as T;\n };\n\n const rows = async (text: string, params: unknown[]) =>\n (await (await ensureTable()).query(text, params)).rows;\n\n const one = async (text: string, params: unknown[]) => {\n const [row] = await rows(text, params);\n return row ? parseEvent(row.data) : null;\n };\n\n return {\n async getItem<T>(key: string): Promise<T | null> {\n const [row] = await rows(`SELECT value FROM ${table} WHERE key = $1`, [key]);\n if (row === undefined || row.value === null || row.value === undefined) return null;\n return parseValue<T>(row.value);\n },\n\n async setItem<T>(key: string, value: T): Promise<void> {\n await rows(\n `INSERT INTO ${table} (key, value) VALUES ($1, $2::jsonb)\n ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value`,\n [key, JSON.stringify(value)],\n );\n },\n\n async removeItem(key: string): Promise<void> {\n await rows(`DELETE FROM ${table} WHERE key = $1`, [key]);\n },\n\n async getKeys(prefix: string): Promise<string[]> {\n const found = await rows(`SELECT key FROM ${table} WHERE key LIKE $1 ESCAPE '\\\\'`, [\n `${escapeLike(prefix)}%`,\n ]);\n // Exact prefix semantics whatever the column collation.\n return found.map((row) => String(row.key)).filter((key) => key.startsWith(prefix));\n },\n\n // ---- native event log --------------------------------------------------------------------\n\n async appendEvents(tenant, events, { expectedSeq }): Promise<void> {\n if (events.length === 0) return;\n assertContiguous(tenant, events, expectedSeq);\n const eventRows = events.map((e) => {\n const c = eventColumns(e);\n return {\n tenant: c.tenant,\n seq: c.seq,\n id: c.id,\n action: c.action,\n occurred_at: c.occurredAt,\n recorded_at: c.recordedAt,\n actor_id: c.actorId,\n actor_type: c.actorType,\n outcome: c.outcome,\n search: c.search,\n data: e,\n };\n });\n const targetRows = events.flatMap((e) =>\n eventTargets(e).map((t) => ({ seq: e.seq, type: t.type, target_id: t.targetId })),\n );\n let inserted: number;\n try {\n const [row] = await rows(\n `WITH head AS (\n SELECT COALESCE(MAX(seq), 0) AS seq FROM ${ev} WHERE tenant = $1\n ), ok AS (\n SELECT 1 FROM head WHERE head.seq = $2 OR head.seq = 0\n ), ins AS (\n INSERT INTO ${ev} (${EVENT_COLUMNS})\n SELECT ${EVENT_COLUMNS} FROM jsonb_to_recordset($3::jsonb) AS ${EVENT_RECORD}\n WHERE EXISTS (SELECT 1 FROM ok)\n RETURNING seq\n ), tgt AS (\n INSERT INTO ${tg} (tenant, seq, type, target_id)\n SELECT $1, r.seq, r.type, r.target_id\n FROM jsonb_to_recordset($4::jsonb) AS r(seq bigint, type text, target_id text)\n WHERE EXISTS (SELECT 1 FROM ok)\n )\n SELECT COUNT(*) AS n FROM ins`,\n [tenant, expectedSeq, JSON.stringify(eventRows), JSON.stringify(targetRows)],\n );\n inserted = Number(row?.n ?? 0);\n } catch (err) {\n if (isWriteConflict(err)) throw new ChainConflictError(tenant, expectedSeq);\n throw err;\n }\n if (inserted !== events.length) throw new ChainConflictError(tenant, expectedSeq);\n },\n\n getEvent: (tenant, id) =>\n one(`SELECT data FROM ${ev} WHERE tenant = $1 AND id = $2`, [tenant, id]),\n\n lastEvent: (tenant) =>\n one(`SELECT data FROM ${ev} WHERE tenant = $1 ORDER BY seq DESC LIMIT 1`, [tenant]),\n\n async eventsBySeq(tenant, { afterSeq, limit }) {\n const found = await rows(\n `SELECT data FROM ${ev} WHERE tenant = $1 AND seq > $2 ORDER BY seq ASC LIMIT $3`,\n [tenant, afterSeq, limit],\n );\n return found.map((r) => parseEvent(r.data));\n },\n\n async queryEvents(q) {\n const { sql, args } = compileEventQuery(\"postgres\", names, q);\n return toQueryResult(await rows(sql, args), q.limit);\n },\n\n async replaceEvent(event): Promise<void> {\n const c = eventColumns(event);\n const targets = eventTargets(event).map((t) => ({ type: t.type, target_id: t.targetId }));\n // One statement: the UPDATE gates the target rewrite (same tenant/seq/id only).\n await rows(\n `WITH upd AS (\n UPDATE ${ev} SET action = $4, occurred_at = $5, recorded_at = $6, actor_id = $7,\n actor_type = $8, outcome = $9, search = $10, data = $11::jsonb\n WHERE tenant = $1 AND seq = $2 AND id = $3\n RETURNING tenant, seq\n ), del AS (\n DELETE FROM ${tg} t USING upd WHERE t.tenant = upd.tenant AND t.seq = upd.seq\n ), ins AS (\n INSERT INTO ${tg} (tenant, seq, type, target_id)\n SELECT upd.tenant, upd.seq, r.type, r.target_id\n FROM upd, jsonb_to_recordset($12::jsonb) AS r(type text, target_id text)\n )\n SELECT COUNT(*) AS n FROM upd`,\n [\n c.tenant,\n c.seq,\n c.id,\n c.action,\n c.occurredAt,\n c.recordedAt,\n c.actorId,\n c.actorType,\n c.outcome,\n c.search,\n JSON.stringify(event),\n JSON.stringify(targets),\n ],\n );\n },\n\n async deleteEventsThrough(tenant, throughSeq) {\n const [row] = await rows(\n `WITH d AS (\n DELETE FROM ${ev} WHERE tenant = $1 AND seq <= $2 RETURNING 1\n ), dt AS (\n DELETE FROM ${tg} WHERE tenant = $1 AND seq <= $2\n )\n SELECT COUNT(*) AS n FROM d`,\n [tenant, throughSeq],\n );\n return Number(row?.n ?? 0);\n },\n\n async countEvents(tenant) {\n const [row] =\n tenant !== undefined\n ? await rows(`SELECT COUNT(*) AS n FROM ${ev} WHERE tenant = $1`, [tenant])\n : await rows(`SELECT COUNT(*) AS n FROM ${ev}`, []);\n return Number(row?.n ?? 0);\n },\n\n async listEventTenants() {\n const found = await rows(`SELECT DISTINCT tenant FROM ${ev} ORDER BY tenant`, []);\n return found.map((r) => String(r.tenant));\n },\n\n async close(): Promise<void> {\n if (ownsClient && client?.end) await client.end();\n },\n } satisfies PostgresAuditStorage;\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
const require_contract = require("./contract-DYvBNdnR.cjs");
|
|
3
|
+
//#region src/storage/redis.ts
|
|
4
|
+
/**
|
|
5
|
+
* Build the compare-and-swap Lua script around a read and a write expression.
|
|
6
|
+
* `KEYS[1]` is the key; `ARGV[1]` is `"1"` when the expected value is `null`
|
|
7
|
+
* (key must be absent); `ARGV[2]` is the expected value as JSON; `ARGV[3]` is
|
|
8
|
+
* the next value as JSON. Returns `1` when swapped, `0` otherwise. Values are
|
|
9
|
+
* compared structurally (decoded with `cjson`), mirroring the memory driver's
|
|
10
|
+
* deep equality.
|
|
11
|
+
*/
|
|
12
|
+
function casScript(read, write) {
|
|
13
|
+
return `
|
|
14
|
+
local function eq(a, b)
|
|
15
|
+
if type(a) ~= type(b) then return false end
|
|
16
|
+
if type(a) ~= 'table' then return a == b end
|
|
17
|
+
for k, v in pairs(a) do
|
|
18
|
+
if not eq(v, b[k]) then return false end
|
|
19
|
+
end
|
|
20
|
+
for k in pairs(b) do
|
|
21
|
+
if a[k] == nil then return false end
|
|
22
|
+
end
|
|
23
|
+
return true
|
|
24
|
+
end
|
|
25
|
+
local current = ${read}
|
|
26
|
+
if ARGV[1] == '1' then
|
|
27
|
+
if current then return 0 end
|
|
28
|
+
else
|
|
29
|
+
if not current then return 0 end
|
|
30
|
+
if current ~= ARGV[2] and not eq(cjson.decode(current), cjson.decode(ARGV[2])) then
|
|
31
|
+
return 0
|
|
32
|
+
end
|
|
33
|
+
end
|
|
34
|
+
${write}
|
|
35
|
+
return 1`;
|
|
36
|
+
}
|
|
37
|
+
/** Plain strings containing JSON — works on any Redis. */
|
|
38
|
+
const stringCodec = {
|
|
39
|
+
async get(c, key) {
|
|
40
|
+
const raw = await c.get(key);
|
|
41
|
+
return raw === null ? null : JSON.parse(raw);
|
|
42
|
+
},
|
|
43
|
+
async set(c, key, value) {
|
|
44
|
+
await c.set(key, JSON.stringify(value));
|
|
45
|
+
},
|
|
46
|
+
casScript: casScript("redis.call('GET', KEYS[1])", "redis.call('SET', KEYS[1], ARGV[3])")
|
|
47
|
+
};
|
|
48
|
+
/** Native RedisJSON documents — requires the JSON module on the server. */
|
|
49
|
+
const jsonCodec = {
|
|
50
|
+
async get(c, key) {
|
|
51
|
+
return await requireJson(c).get(key) ?? null;
|
|
52
|
+
},
|
|
53
|
+
async set(c, key, value) {
|
|
54
|
+
await requireJson(c).set(key, "$", value);
|
|
55
|
+
},
|
|
56
|
+
casScript: casScript("redis.call('JSON.GET', KEYS[1])", "redis.call('JSON.SET', KEYS[1], '$', ARGV[3])")
|
|
57
|
+
};
|
|
58
|
+
function requireJson(c) {
|
|
59
|
+
if (!c.json) throw new Error("createRedisJSONStorage: the client exposes no `json` commands — use node-redis (the `redis` package) v4+, and a server with the RedisJSON module (Redis 8 / Redis Stack).");
|
|
60
|
+
return c.json;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Create a Redis-backed {@link RedisAuditStorage}. Connection is lazy: the
|
|
64
|
+
* client is created/connected on the first storage operation and reused
|
|
65
|
+
* thereafter, guarded by a single connection promise so concurrent calls connect
|
|
66
|
+
* once.
|
|
67
|
+
*
|
|
68
|
+
* @example
|
|
69
|
+
* ```ts
|
|
70
|
+
* import { createRedisStorage } from "@xtandard/audit/storage/redis";
|
|
71
|
+
*
|
|
72
|
+
* const storage = createRedisStorage({
|
|
73
|
+
* url: process.env.REDIS_URL ?? "redis://localhost:6379",
|
|
74
|
+
* prefix: "myapp:audit",
|
|
75
|
+
* onError: (err) => console.error("[audit/redis]", err),
|
|
76
|
+
* });
|
|
77
|
+
*
|
|
78
|
+
* // Disconnect when the process exits:
|
|
79
|
+
* // process.on("SIGTERM", () => storage.close());
|
|
80
|
+
* ```
|
|
81
|
+
*/
|
|
82
|
+
function createRedisStorage(options) {
|
|
83
|
+
return buildRedisStorage(options, stringCodec);
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Create a Redis-backed {@link RedisAuditStorage} that stores values as native
|
|
87
|
+
* **RedisJSON** documents (`JSON.SET`/`JSON.GET`) instead of strings — making
|
|
88
|
+
* the stored records queryable with JSONPath (`JSON.GET key $.action`) and
|
|
89
|
+
* indexable with RediSearch, while the audit system behaves identically.
|
|
90
|
+
*
|
|
91
|
+
* Requires the JSON module on the server (built into Redis 8; Redis Stack; or
|
|
92
|
+
* `redisjson` loaded). Same options and semantics as {@link createRedisStorage},
|
|
93
|
+
* including lazy connection, `SCAN`-based `getKeys`, keyspace-notification
|
|
94
|
+
* `watch`, and the Lua `compareAndSwap`. **Do not point it at keys written by
|
|
95
|
+
* `createRedisStorage`** (or vice versa) — the underlying types differ and
|
|
96
|
+
* Redis answers `WRONGTYPE`.
|
|
97
|
+
*
|
|
98
|
+
* @example
|
|
99
|
+
* ```ts
|
|
100
|
+
* import { createRedisJSONStorage } from "@xtandard/audit/storage/redis";
|
|
101
|
+
*
|
|
102
|
+
* const storage = createRedisJSONStorage({
|
|
103
|
+
* url: process.env.REDIS_URL ?? "redis://localhost:6379",
|
|
104
|
+
* prefix: "myapp:audit",
|
|
105
|
+
* });
|
|
106
|
+
* // Then, in redis-cli: JSON.GET myapp:audit:aud/t/acme/events/000000000001 $.action
|
|
107
|
+
* ```
|
|
108
|
+
*/
|
|
109
|
+
function createRedisJSONStorage(options) {
|
|
110
|
+
return buildRedisStorage(options, jsonCodec);
|
|
111
|
+
}
|
|
112
|
+
/** Shared implementation — connection, prefixing, SCAN, CAS, watch, close. */
|
|
113
|
+
function buildRedisStorage(options, codec) {
|
|
114
|
+
const { url, prefix } = options;
|
|
115
|
+
const fullPrefix = prefix ? `${prefix}:` : "";
|
|
116
|
+
const ownsClient = !options.client;
|
|
117
|
+
let client = options.client;
|
|
118
|
+
let connecting;
|
|
119
|
+
const attachErrorHandler = (c) => {
|
|
120
|
+
c.on?.("error", (err) => options.onError?.(err));
|
|
121
|
+
};
|
|
122
|
+
if (client) attachErrorHandler(client);
|
|
123
|
+
/** Resolve a connected client, creating/connecting on first use. */
|
|
124
|
+
async function getClient() {
|
|
125
|
+
if (client?.isOpen) return client;
|
|
126
|
+
connecting ??= (async () => {
|
|
127
|
+
if (!client) {
|
|
128
|
+
let createClient;
|
|
129
|
+
try {
|
|
130
|
+
({createClient} = await import("redis"));
|
|
131
|
+
} catch {
|
|
132
|
+
require_contract.requirePeer("redis", "storage/redis");
|
|
133
|
+
}
|
|
134
|
+
client = createClient({
|
|
135
|
+
url,
|
|
136
|
+
disableOfflineQueue: true,
|
|
137
|
+
socket: { reconnectStrategy: (retries) => Math.min(retries * 100, 3e3) }
|
|
138
|
+
});
|
|
139
|
+
attachErrorHandler(client);
|
|
140
|
+
}
|
|
141
|
+
if (!client.isOpen) await client.connect();
|
|
142
|
+
return client;
|
|
143
|
+
})();
|
|
144
|
+
try {
|
|
145
|
+
return await connecting;
|
|
146
|
+
} finally {
|
|
147
|
+
connecting = void 0;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
/** Prepend the namespace to a caller key. */
|
|
151
|
+
const toRedisKey = (key) => `${fullPrefix}${key}`;
|
|
152
|
+
/** Strip the namespace off a Redis key, yielding the caller key. */
|
|
153
|
+
const fromRedisKey = (key) => fullPrefix && key.startsWith(fullPrefix) ? key.slice(fullPrefix.length) : key;
|
|
154
|
+
return {
|
|
155
|
+
async getItem(key) {
|
|
156
|
+
const c = await getClient();
|
|
157
|
+
return await codec.get(c, toRedisKey(key)) ?? null;
|
|
158
|
+
},
|
|
159
|
+
async setItem(key, value) {
|
|
160
|
+
const c = await getClient();
|
|
161
|
+
await codec.set(c, toRedisKey(key), value);
|
|
162
|
+
},
|
|
163
|
+
async removeItem(key) {
|
|
164
|
+
await (await getClient()).del(toRedisKey(key));
|
|
165
|
+
},
|
|
166
|
+
async getKeys(prefix) {
|
|
167
|
+
const c = await getClient();
|
|
168
|
+
const match = `${escapeGlob(toRedisKey(prefix))}*`;
|
|
169
|
+
const out = [];
|
|
170
|
+
for await (const entry of c.scanIterator({
|
|
171
|
+
MATCH: match,
|
|
172
|
+
COUNT: 100
|
|
173
|
+
})) if (Array.isArray(entry)) for (const k of entry) out.push(fromRedisKey(k));
|
|
174
|
+
else out.push(fromRedisKey(entry));
|
|
175
|
+
return out.filter((key) => key.startsWith(prefix));
|
|
176
|
+
},
|
|
177
|
+
async compareAndSwap(input) {
|
|
178
|
+
const swapped = await (await getClient()).eval(codec.casScript, {
|
|
179
|
+
keys: [toRedisKey(input.key)],
|
|
180
|
+
arguments: [
|
|
181
|
+
input.expected === null ? "1" : "0",
|
|
182
|
+
input.expected === null ? "" : JSON.stringify(input.expected),
|
|
183
|
+
JSON.stringify(input.next)
|
|
184
|
+
]
|
|
185
|
+
});
|
|
186
|
+
return Number(swapped) === 1;
|
|
187
|
+
},
|
|
188
|
+
async watch(prefix, callback) {
|
|
189
|
+
const subscriber = (await getClient()).duplicate();
|
|
190
|
+
attachErrorHandler(subscriber);
|
|
191
|
+
await subscriber.connect();
|
|
192
|
+
const pattern = `__keyspace@*__:${escapeGlob(toRedisKey(prefix))}*`;
|
|
193
|
+
await subscriber.pSubscribe(pattern, (event, channel) => {
|
|
194
|
+
const idx = channel.indexOf("__:");
|
|
195
|
+
if (idx === -1) return;
|
|
196
|
+
const key = fromRedisKey(channel.slice(idx + 3));
|
|
197
|
+
if (!key.startsWith(prefix)) return;
|
|
198
|
+
callback({
|
|
199
|
+
type: event === "del" || event === "expired" ? "remove" : "update",
|
|
200
|
+
key
|
|
201
|
+
});
|
|
202
|
+
});
|
|
203
|
+
return () => {
|
|
204
|
+
subscriber.disconnect();
|
|
205
|
+
};
|
|
206
|
+
},
|
|
207
|
+
async close() {
|
|
208
|
+
if (ownsClient && client?.isOpen) await client.quit();
|
|
209
|
+
}
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* Escape Redis glob metacharacters (`*`, `?`, `[`, `]`, `\`) so a literal key
|
|
214
|
+
* prefix can be used in `SCAN MATCH` / `PSUBSCRIBE` patterns.
|
|
215
|
+
*/
|
|
216
|
+
function escapeGlob(input) {
|
|
217
|
+
return input.replace(/[*?[\]\\]/g, "\\$&");
|
|
218
|
+
}
|
|
219
|
+
//#endregion
|
|
220
|
+
exports.createRedisJSONStorage = createRedisJSONStorage;
|
|
221
|
+
exports.createRedisStorage = createRedisStorage;
|
|
222
|
+
|
|
223
|
+
//# sourceMappingURL=entry-storage-redis.cjs.map
|