@adaptware/eagles-db 0.5.72 → 0.5.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.72",
+  "version": "0.5.74",
   "description": "A Prisma client package for Treadspace database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/schema/assessment.prisma

@@ -17,6 +17,8 @@ model Assessment {
   /// Attempt Expires At
   attempt_expires_at    DateTime?
   evaluated_at          DateTime?
+  /// When this moves forward, prior INTERVIEW_SESSION grants with reference ASSESSMENT are stale.
+  consent_epoch_at      DateTime                    @default(now())
   /// Audit fields
   created_at            DateTime                    @default(now())
   updated_at            DateTime                    @updatedAt

package/prisma/schema/consent.prisma

@@ -0,0 +1,132 @@
+/// Candidate consent catalog, audit records, and erasure planning (dry-run v1).
+
+enum ConsentType {
+  PLATFORM_TERMS
+  INTERVIEW_SESSION
+
+  @@schema("public")
+}
+
+enum ConsentReferenceType {
+  INTERVIEW
+  ASSESSMENT
+
+  @@schema("public")
+}
+
+enum ConsentOutcome {
+  GRANTED
+  DECLINED
+
+  @@schema("public")
+}
+
+enum DataErasureTrigger {
+  ADMIN
+  USER_REQUEST
+  RETENTION_POLICY
+  CONSENT_WITHDRAWAL
+
+  @@schema("public")
+}
+
+enum DataErasureMode {
+  DRY_RUN
+  EXECUTE
+
+  @@schema("public")
+}
+
+enum DataErasureRequestStatus {
+  PLANNED
+  APPROVED
+  EXECUTED
+  REJECTED
+  FAILED
+
+  @@schema("public")
+}
+
+model ConsentDocument {
+  id           String       @id @default(uuid())
+  /// Stable key, e.g. PLATFORM_TERMS, INTERVIEW_SESSION_DEFAULT
+  slug         String       @unique
+  consent_type ConsentType
+  is_active    Boolean      @default(true)
+  created_at   DateTime     @default(now())
+  updated_at   DateTime     @updatedAt
+  versions     ConsentDocumentVersion[]
+
+  @@schema("public")
+}
+
+model ConsentDocumentVersion {
+  id              String   @id @default(uuid())
+  document_id     String
+  document        ConsentDocument @relation(fields: [document_id], references: [id], onDelete: Cascade)
+  version_number  Int
+  content_hash    String
+  locale          String   @default("en-IN")
+  content         String   @db.Text
+  published_at    DateTime?
+  created_at      DateTime @default(now())
+  checkboxes      ConsentCheckboxDefinition[]
+  consent_records ConsentRecord[]
+
+  @@unique([document_id, version_number])
+  @@index([document_id, published_at(sort: Desc)])
+  @@schema("public")
+}
+
+model ConsentCheckboxDefinition {
+  id                  String               @id @default(uuid())
+  document_version_id String
+  document_version    ConsentDocumentVersion @relation(fields: [document_version_id], references: [id], onDelete: Cascade)
+  /// Stable machine key in ConsentRecord.selections JSON
+  checkbox_key        String
+  label               String
+  sort_order          Int                  @default(0)
+  default_required_hint Boolean            @default(true)
+
+  @@unique([document_version_id, checkbox_key])
+  @@schema("public")
+}
+
+model ConsentRecord {
+  id                  String                @id @default(uuid())
+  user_id             String
+  user                User                  @relation(fields: [user_id], references: [id], onDelete: Cascade)
+  consent_type        ConsentType
+  outcome             ConsentOutcome
+  document_version_id String
+  document_version    ConsentDocumentVersion @relation(fields: [document_version_id], references: [id], onDelete: Restrict)
+  selections          Json                  @default("{}")
+  reference_type      ConsentReferenceType?
+  reference_id        String?
+  ip_address          String?
+  user_agent          String?
+  decline_reason      String?
+  created_at          DateTime              @default(now())
+
+  @@index([user_id, consent_type, created_at(sort: Desc)])
+  @@index([reference_type, reference_id, consent_type, created_at(sort: Desc)])
+  @@schema("public")
+}
+
+/// Append-only erasure plan snapshots (v1: DRY_RUN only in application code).
+model DataErasureRequest {
+  id               String                   @id @default(uuid())
+  subject_user_id  String
+  subject_user     User                     @relation("ErasureSubjectUser", fields: [subject_user_id], references: [id], onDelete: Cascade)
+  trigger          DataErasureTrigger
+  mode             DataErasureMode          @default(DRY_RUN)
+  status           DataErasureRequestStatus @default(PLANNED)
+  plan             Json                     @default("{}")
+  planner_version  String
+  requested_by_id  String?
+  requested_by     User?                    @relation("ErasureRequestedByUser", fields: [requested_by_id], references: [id], onDelete: SetNull)
+  created_at       DateTime                 @default(now())
+
+  @@index([subject_user_id, created_at(sort: Desc)])
+  @@schema("public")
+}

package/prisma/schema/interview.prisma

@@ -86,12 +86,12 @@ model Interview {
   /// When final human feedback was submitted.
   evaluated_at                  DateTime?
 
-  /// Candidate Acceptance & DPDP Consent
-  candidate_status       String?   @default("INVITED")
-  dpdp_consent_given     Boolean   @default(false)
-  dpdp_consent_given_at  DateTime?
-  candidate_responded_at DateTime?
-  decline_reason         String?
+  /// Candidate invite response (legal consent in ConsentRecord).
+  candidate_status          String?            @default("INVITED")
+  candidate_responded_at    DateTime?
+  decline_reason            String?
+  /// When this timestamp moves forward, prior INTERVIEW_SESSION consent grants are stale.
+  consent_epoch_at          DateTime           @default(now())
 
   /// Self-scheduling
   reschedule_count          Int       @default(0)

package/prisma/schema/migrations/20261001120000_candidate_consent_and_erasure_plan/migration.sql

@@ -0,0 +1,136 @@
+-- CreateEnum
+CREATE TYPE "ConsentType" AS ENUM ('PLATFORM_TERMS', 'INTERVIEW_SESSION');
+
+-- CreateEnum
+CREATE TYPE "ConsentReferenceType" AS ENUM ('INTERVIEW');
+
+-- CreateEnum
+CREATE TYPE "ConsentOutcome" AS ENUM ('GRANTED', 'DECLINED');
+
+-- CreateEnum
+CREATE TYPE "DataErasureTrigger" AS ENUM ('ADMIN', 'USER_REQUEST', 'RETENTION_POLICY', 'CONSENT_WITHDRAWAL');
+
+-- CreateEnum
+CREATE TYPE "DataErasureMode" AS ENUM ('DRY_RUN', 'EXECUTE');
+
+-- CreateEnum
+CREATE TYPE "DataErasureRequestStatus" AS ENUM ('PLANNED', 'APPROVED', 'EXECUTED', 'REJECTED', 'FAILED');
+
+-- AlterTable
+ALTER TABLE "Interview" ADD COLUMN "consent_epoch_at" TIMESTAMP(3);
+
+UPDATE "Interview"
+SET "consent_epoch_at" = COALESCE("last_rescheduled_at", "created_at", CURRENT_TIMESTAMP);
+
+ALTER TABLE "Interview" ALTER COLUMN "consent_epoch_at" SET NOT NULL;
+ALTER TABLE "Interview" ALTER COLUMN "consent_epoch_at" SET DEFAULT CURRENT_TIMESTAMP;
+
+-- CreateTable
+CREATE TABLE "ConsentDocument" (
+    "id" TEXT NOT NULL,
+    "slug" TEXT NOT NULL,
+    "consent_type" "ConsentType" NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ConsentDocument_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ConsentDocumentVersion" (
+    "id" TEXT NOT NULL,
+    "document_id" TEXT NOT NULL,
+    "version_number" INTEGER NOT NULL,
+    "content_hash" TEXT NOT NULL,
+    "locale" TEXT NOT NULL DEFAULT 'en-IN',
+    "content" TEXT NOT NULL,
+    "published_at" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ConsentDocumentVersion_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ConsentCheckboxDefinition" (
+    "id" TEXT NOT NULL,
+    "document_version_id" TEXT NOT NULL,
+    "checkbox_key" TEXT NOT NULL,
+    "label" TEXT NOT NULL,
+    "sort_order" INTEGER NOT NULL DEFAULT 0,
+    "default_required_hint" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "ConsentCheckboxDefinition_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ConsentRecord" (
+    "id" TEXT NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "consent_type" "ConsentType" NOT NULL,
+    "outcome" "ConsentOutcome" NOT NULL,
+    "document_version_id" TEXT NOT NULL,
+    "selections" JSONB NOT NULL DEFAULT '{}',
+    "reference_type" "ConsentReferenceType",
+    "reference_id" TEXT,
+    "ip_address" TEXT,
+    "user_agent" TEXT,
+    "decline_reason" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ConsentRecord_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "DataErasureRequest" (
+    "id" TEXT NOT NULL,
+    "subject_user_id" TEXT NOT NULL,
+    "trigger" "DataErasureTrigger" NOT NULL,
+    "mode" "DataErasureMode" NOT NULL DEFAULT 'DRY_RUN',
+    "status" "DataErasureRequestStatus" NOT NULL DEFAULT 'PLANNED',
+    "plan" JSONB NOT NULL DEFAULT '{}',
+    "planner_version" TEXT NOT NULL,
+    "requested_by_id" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "DataErasureRequest_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ConsentDocument_slug_key" ON "ConsentDocument"("slug");
+
+-- CreateIndex
+CREATE INDEX "ConsentDocumentVersion_document_id_published_at_idx" ON "ConsentDocumentVersion"("document_id", "published_at" DESC);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ConsentDocumentVersion_document_id_version_number_key" ON "ConsentDocumentVersion"("document_id", "version_number");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ConsentCheckboxDefinition_document_version_id_checkbox_key_key" ON "ConsentCheckboxDefinition"("document_version_id", "checkbox_key");
+
+-- CreateIndex
+CREATE INDEX "ConsentRecord_user_id_consent_type_created_at_idx" ON "ConsentRecord"("user_id", "consent_type", "created_at" DESC);
+
+-- CreateIndex
+CREATE INDEX "ConsentRecord_reference_type_reference_id_consent_type_crea_idx" ON "ConsentRecord"("reference_type", "reference_id", "consent_type", "created_at" DESC);
+
+-- CreateIndex
+CREATE INDEX "DataErasureRequest_subject_user_id_created_at_idx" ON "DataErasureRequest"("subject_user_id", "created_at" DESC);
+
+-- AddForeignKey
+ALTER TABLE "ConsentDocumentVersion" ADD CONSTRAINT "ConsentDocumentVersion_document_id_fkey" FOREIGN KEY ("document_id") REFERENCES "ConsentDocument"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ConsentCheckboxDefinition" ADD CONSTRAINT "ConsentCheckboxDefinition_document_version_id_fkey" FOREIGN KEY ("document_version_id") REFERENCES "ConsentDocumentVersion"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ConsentRecord" ADD CONSTRAINT "ConsentRecord_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ConsentRecord" ADD CONSTRAINT "ConsentRecord_document_version_id_fkey" FOREIGN KEY ("document_version_id") REFERENCES "ConsentDocumentVersion"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "DataErasureRequest" ADD CONSTRAINT "DataErasureRequest_subject_user_id_fkey" FOREIGN KEY ("subject_user_id") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "DataErasureRequest" ADD CONSTRAINT "DataErasureRequest_requested_by_id_fkey" FOREIGN KEY ("requested_by_id") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20261003103000_assessment_consent_ref_drop_interview_dpdp/migration.sql

@@ -0,0 +1,16 @@
+-- Extend consent references for proctored assessments (v1 scaffold).
+ALTER TYPE "ConsentReferenceType" ADD VALUE 'ASSESSMENT';
+
+-- Assessment session consent staleness (mirrors Interview.consent_epoch_at).
+ALTER TABLE "Assessment" ADD COLUMN "consent_epoch_at" TIMESTAMP(3);
+
+UPDATE "Assessment"
+SET "consent_epoch_at" = COALESCE("updated_at", "created_at", CURRENT_TIMESTAMP)
+WHERE "consent_epoch_at" IS NULL;
+
+ALTER TABLE "Assessment" ALTER COLUMN "consent_epoch_at" SET NOT NULL;
+ALTER TABLE "Assessment" ALTER COLUMN "consent_epoch_at" SET DEFAULT CURRENT_TIMESTAMP;
+
+-- Legacy interview DPDP flags replaced by ConsentRecord (+ backfill).
+ALTER TABLE "Interview" DROP COLUMN IF EXISTS "dpdp_consent_given";
+ALTER TABLE "Interview" DROP COLUMN IF EXISTS "dpdp_consent_given_at";

package/prisma/schema/user.prisma

@@ -103,6 +103,9 @@ model User {
 
   department_members     DepartmentMember[]      @relation("DepartmentMemberships")
   assigned_hiring_units  PurchasedHiringUnit[]   @relation("AssignedHiringUnits")
+  consent_records        ConsentRecord[]
+  erasure_requests_as_subject DataErasureRequest[] @relation("ErasureSubjectUser")
+  erasure_requests_requested  DataErasureRequest[] @relation("ErasureRequestedByUser")
 
   @@index([role_id])
   @@index([permission_id])

package/prisma/migrations/20260519120000_migrate_shortlisted_to_selected/migration.sql

@@ -1,2 +0,0 @@
--- Migrate legacy terminal-positive status to SELECTED (SHORTLISTED enum value retained but unused).
-UPDATE applications SET status = 'SELECTED' WHERE status = 'SHORTLISTED';