Repository navigation
Security safeguards and access logs (Rule 6 of the DPDP Rules), plus Fastify and NestJS guards, events, NOT NULL erasure and daily upkeep.
Added
- Access log (Rule 6(1)(c), (e)):
dpdp.access.log(),list(),review()andprune(). Records who accessed whose personal data, for which purpose and which fields; flags fields read for a purpose they aren't held for (or refuses them withaccess: { outOfPurpose: "throw" }).review()reports out-of-purpose reads, consent purposes used without consent at the time, and bulk access (ignoreActorsexempts batch jobs).prune()keeps at least a year. dpdp-kit/protect(Rule 6(1)(a)):createEncryptor(AES-256-GCM, tamper detection, row-binding context, key rotation),createTokenizer(keyed HMAC tokens for lookups),mask,maskPhone,maskEmail,maskAadhaar,maskPan,generateKey.- Rule 6 in the config and audit:
protecton fields,contracton processors, asecurityblock (accessControl,backups,measures,accessLogRetention). New audit warnings:unprotected-high-risk-field,processor-contract-missing,security-measure-missing; new errors:access-log-retention-too-short,invalid-erase. npx dpdp-kit safeguards: Rule 6(1)(a)–(g), what's recorded and what's missing;--strictfails on gaps.- Guards:
dpdp-kit/fastify(requireConsent,logAccessaspreHandlerhooks) anddpdp-kit/nestjs(consentGuard,accessLogGuard), pluslogAccessfor Express and Hono. - Events:
dpdp.on()forconsent.granted,consent.withdrawn,erasure.scheduled,retention.ran,rights.opened,rights.closed,access.logged,daily.ran. eraseon fields:"null"(default),"redact"or{ value }(fixed or a function), soNOT NULLandUNIQUEcolumns can be erased.- Daily upkeep:
dpdp.daily()(erasure, access-log pruning and review, overdue requests) andstartDaily()indpdp-kit/schedule. Each step runs even if another fails (failures are inreport.errors), andstartDailystarts each review where the last successful one ended, so a failed night isn't skipped. audit --schemachecks erase settings against the columns:erase-not-nullwhen aNOT NULLcolumn would be erased toNULL,erase-type-mismatchwhen the replacement doesn't fit the column. Without it, such a mistake shows up only when the task runs, often a year later.- NestJS guards take a
requestoption for GraphQL and other non-HTTP contexts; the Fastify guard falls back to 403 ifonDeniedsends nothing; event listeners each get their own copy of the payload; concurrent consent writes for one person back off with jitter.
Upgrading from 0.2.x
- New table. Add
accessLogto your Drizzle schema (export { accessLog } from "dpdp-kit/drizzle") and generate a migration, or runACCESS_LOG_DDL. - New audit warnings. If you run
dpdp-kit audit --strict, add asecurityblock and acontractfor each processor first, and mark high-risk fields withprotect(or the build will fail on the new warnings). - Custom
DataAccess.eraseFieldsnow gets an optional fifth argument with each column's replacement value. Implementations that ignore it keep writingNULL, as before. - Custom stores. The access log needs
AccessLogStore(insertAccess,listAccess,pruneAccess). Without it,dpdp.accessthrowsstore-unsupportedanddaily()skips it.
Install
npm i dpdp-kit@0.3.0