@axova/shared 1.0.0

package/dist/schemas/compliance/kyc-schema.js

@@ -0,0 +1,361 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kycAnalyticsRelations = exports.kycWebhooksLogRelations = exports.kycDocumentsRelations = exports.kycVerificationHistoryRelations = exports.storeKycRelations = exports.kycWebhooksLog = exports.kycAnalytics = exports.kycDocuments = exports.kycVerificationHistory = exports.storeKyc = void 0;
+const cuid2_1 = require("@paralleldrive/cuid2");
+const drizzle_orm_1 = require("drizzle-orm");
+const pg_core_1 = require("drizzle-orm/pg-core");
+const compliance_schema_1 = require("./compliance-schema");
+// Store KYC Records - Main table for KYC verification per store
+exports.storeKyc = (0, pg_core_1.pgTable)("store_kyc", {
+    id: (0, pg_core_1.text)("id")
+        .primaryKey()
+        .$defaultFn(() => (0, cuid2_1.createId)()),
+    storeId: (0, pg_core_1.text)("store_id").notNull(),
+    userId: (0, pg_core_1.text)("user_id").notNull(),
+    // Didit Integration
+    diditSessionId: (0, pg_core_1.text)("didit_session_id"),
+    diditWorkflowId: (0, pg_core_1.text)("didit_workflow_id"),
+    diditVerificationUrl: (0, pg_core_1.text)("didit_verification_url"),
+    // KYC Status
+    kycStatus: (0, pg_core_1.varchar)("kyc_status", { length: 30 })
+        .notNull()
+        .default("NOT_STARTED")
+        .$type(),
+    kycLevel: (0, pg_core_1.varchar)("kyc_level", { length: 20 })
+        .$type()
+        .default("BASIC"),
+    verificationTier: (0, pg_core_1.varchar)("verification_tier", { length: 30 })
+        .$type()
+        .default("TIER_0_UNVERIFIED"),
+    // Verification Types Completed
+    verificationsCompleted: (0, pg_core_1.jsonb)("verifications_completed")
+        .$type()
+        .default({}),
+    // Verification Scores
+    verificationScore: (0, pg_core_1.decimal)("verification_score", {
+        precision: 5,
+        scale: 2,
+    }), // 0-100
+    confidenceScore: (0, pg_core_1.decimal)("confidence_score", { precision: 5, scale: 2 }), // 0-100
+    riskScore: (0, pg_core_1.decimal)("risk_score", { precision: 5, scale: 2 }), // 0-100
+    // Risk Assessment
+    riskLevel: (0, pg_core_1.varchar)("risk_level", { length: 20 })
+        .$type()
+        .default("MEDIUM"),
+    riskFlags: (0, pg_core_1.jsonb)("risk_flags")
+        .$type()
+        .default({}),
+    // Personal Information (from Didit)
+    personalInfo: (0, pg_core_1.jsonb)("personal_info")
+        .$type()
+        .default({}),
+    // Document Information
+    documentInfo: (0, pg_core_1.jsonb)("document_info")
+        .$type()
+        .default({}),
+    // Address Information
+    addressInfo: (0, pg_core_1.jsonb)("address_info")
+        .$type()
+        .default({}),
+    // Biometric Data (hashed/encrypted references)
+    biometricData: (0, pg_core_1.jsonb)("biometric_data")
+        .$type()
+        .default({}),
+    // AML/Sanctions Screening Results
+    amlResults: (0, pg_core_1.jsonb)("aml_results")
+        .$type()
+        .default({}),
+    // Phone & Email Verification
+    contactVerification: (0, pg_core_1.jsonb)("contact_verification")
+        .$type()
+        .default({}),
+    // Submission & Review Tracking
+    submittedAt: (0, pg_core_1.timestamp)("submitted_at", { withTimezone: true }),
+    submittedBy: (0, pg_core_1.text)("submitted_by"),
+    reviewedAt: (0, pg_core_1.timestamp)("reviewed_at", { withTimezone: true }),
+    reviewedBy: (0, pg_core_1.text)("reviewed_by"),
+    reviewerNotes: (0, pg_core_1.text)("reviewer_notes"),
+    approvedAt: (0, pg_core_1.timestamp)("approved_at", { withTimezone: true }),
+    approvedBy: (0, pg_core_1.text)("approved_by"),
+    rejectedAt: (0, pg_core_1.timestamp)("rejected_at", { withTimezone: true }),
+    rejectedBy: (0, pg_core_1.text)("rejected_by"),
+    rejectionReason: (0, pg_core_1.text)("rejection_reason"),
+    // Expiry & Renewal
+    expiryDate: (0, pg_core_1.timestamp)("expiry_date", { withTimezone: true }),
+    requiresRenewal: (0, pg_core_1.boolean)("requires_renewal").notNull().default(false),
+    lastRenewalDate: (0, pg_core_1.timestamp)("last_renewal_date", { withTimezone: true }),
+    nextRenewalDate: (0, pg_core_1.timestamp)("next_renewal_date", { withTimezone: true }),
+    // Compliance & Regulations
+    complianceChecks: (0, pg_core_1.jsonb)("compliance_checks")
+        .$type()
+        .default({}),
+    regulatoryStatus: (0, pg_core_1.varchar)("regulatory_status", { length: 30 })
+        .$type()
+        .default("PENDING"),
+    // Verification Attempts & History
+    attemptCount: (0, pg_core_1.integer)("attempt_count").notNull().default(0),
+    lastAttemptAt: (0, pg_core_1.timestamp)("last_attempt_at", { withTimezone: true }),
+    maxAttemptsReached: (0, pg_core_1.boolean)("max_attempts_reached")
+        .notNull()
+        .default(false),
+    // Metadata & Configuration
+    verificationMetadata: (0, pg_core_1.jsonb)("verification_metadata")
+        .$type()
+        .default({}),
+    // Internal Notes & Flags
+    internalNotes: (0, pg_core_1.text)("internal_notes"),
+    flags: (0, pg_core_1.jsonb)("flags")
+        .$type()
+        .default({}),
+    // Store-specific KYC Requirements
+    storeKycRequirements: (0, pg_core_1.jsonb)("store_kyc_requirements")
+        .$type()
+        .default({}),
+    createdAt: (0, pg_core_1.timestamp)("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+    updatedAt: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+}, (table) => ({
+    storeIdIndex: (0, pg_core_1.index)("idx_kyc_store_id").on(table.storeId),
+    userIdIndex: (0, pg_core_1.index)("idx_kyc_user_id").on(table.userId),
+    statusIndex: (0, pg_core_1.index)("idx_kyc_status").on(table.kycStatus),
+    diditSessionIndex: (0, pg_core_1.index)("idx_kyc_didit_session").on(table.diditSessionId),
+    tierIndex: (0, pg_core_1.index)("idx_kyc_tier").on(table.verificationTier),
+    riskLevelIndex: (0, pg_core_1.index)("idx_kyc_risk_level").on(table.riskLevel),
+    expiryIndex: (0, pg_core_1.index)("idx_kyc_expiry").on(table.expiryDate, table.requiresRenewal),
+    storeUserUnique: (0, pg_core_1.unique)("unique_store_user_kyc").on(table.storeId, table.userId),
+}));
+// KYC Verification History - Track all verification attempts and changes
+exports.kycVerificationHistory = (0, pg_core_1.pgTable)("kyc_verification_history", {
+    id: (0, pg_core_1.text)("id")
+        .primaryKey()
+        .$defaultFn(() => (0, cuid2_1.createId)()),
+    kycId: (0, pg_core_1.text)("kyc_id")
+        .notNull()
+        .references(() => exports.storeKyc.id, { onDelete: "cascade" }),
+    storeId: (0, pg_core_1.text)("store_id").notNull(),
+    userId: (0, pg_core_1.text)("user_id").notNull(),
+    // Event Details
+    eventType: (0, pg_core_1.varchar)("event_type", { length: 50 })
+        .notNull()
+        .$type(),
+    previousStatus: (0, pg_core_1.varchar)("previous_status", { length: 30 }),
+    newStatus: (0, pg_core_1.varchar)("new_status", { length: 30 }),
+    // Change Details
+    changeDetails: (0, pg_core_1.jsonb)("change_details").$type(),
+    diditEventData: (0, pg_core_1.jsonb)("didit_event_data").$type(),
+    performedBy: (0, pg_core_1.text)("performed_by"),
+    performedByType: (0, pg_core_1.varchar)("performed_by_type", { length: 20 }).$type(),
+    notes: (0, pg_core_1.text)("notes"),
+    createdAt: (0, pg_core_1.timestamp)("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+}, (table) => ({
+    kycIdIndex: (0, pg_core_1.index)("idx_kyc_history_kyc_id").on(table.kycId),
+    storeIdIndex: (0, pg_core_1.index)("idx_kyc_history_store_id").on(table.storeId),
+    eventTypeIndex: (0, pg_core_1.index)("idx_kyc_history_event_type").on(table.eventType),
+    createdAtIndex: (0, pg_core_1.index)("idx_kyc_history_created_at").on(table.createdAt),
+}));
+// KYC Documents - Store references to verification documents
+exports.kycDocuments = (0, pg_core_1.pgTable)("kyc_documents", {
+    id: (0, pg_core_1.text)("id")
+        .primaryKey()
+        .$defaultFn(() => (0, cuid2_1.createId)()),
+    kycId: (0, pg_core_1.text)("kyc_id")
+        .notNull()
+        .references(() => exports.storeKyc.id, { onDelete: "cascade" }),
+    storeId: (0, pg_core_1.text)("store_id").notNull(),
+    userId: (0, pg_core_1.text)("user_id").notNull(),
+    // Document Classification
+    documentType: (0, pg_core_1.varchar)("document_type", { length: 50 })
+        .notNull()
+        .$type(),
+    documentCategory: (0, pg_core_1.varchar)("document_category", { length: 30 }).$type(),
+    // Document Details
+    fileName: (0, pg_core_1.varchar)("file_name", { length: 255 }),
+    fileUrl: (0, pg_core_1.text)("file_url").notNull(),
+    encryptedFileUrl: (0, pg_core_1.text)("encrypted_file_url"),
+    fileSize: (0, pg_core_1.integer)("file_size"),
+    mimeType: (0, pg_core_1.varchar)("mime_type", { length: 50 }),
+    // Document Verification
+    verificationStatus: (0, pg_core_1.varchar)("verification_status", { length: 30 })
+        .notNull()
+        .default("PENDING")
+        .$type(),
+    verifiedBy: (0, pg_core_1.text)("verified_by"),
+    verifiedAt: (0, pg_core_1.timestamp)("verified_at", { withTimezone: true }),
+    verificationNotes: (0, pg_core_1.text)("verification_notes"),
+    // Document Metadata
+    documentMetadata: (0, pg_core_1.jsonb)("document_metadata").$type(),
+    // Security & Compliance
+    isEncrypted: (0, pg_core_1.boolean)("is_encrypted").notNull().default(true),
+    encryptionMethod: (0, pg_core_1.varchar)("encryption_method", { length: 50 }),
+    accessLog: (0, pg_core_1.jsonb)("access_log")
+        .$type()
+        .default([]),
+    // Retention & Deletion
+    retentionPeriod: (0, pg_core_1.integer)("retention_period"), // days
+    scheduledDeletionDate: (0, pg_core_1.timestamp)("scheduled_deletion_date", {
+        withTimezone: true,
+    }),
+    deletedAt: (0, pg_core_1.timestamp)("deleted_at", { withTimezone: true }),
+    deletedBy: (0, pg_core_1.text)("deleted_by"),
+    uploadedAt: (0, pg_core_1.timestamp)("uploaded_at", { withTimezone: true }).defaultNow(),
+    uploadedBy: (0, pg_core_1.text)("uploaded_by"),
+    createdAt: (0, pg_core_1.timestamp)("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+    updatedAt: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+}, (table) => ({
+    kycIdIndex: (0, pg_core_1.index)("idx_kyc_docs_kyc_id").on(table.kycId),
+    storeIdIndex: (0, pg_core_1.index)("idx_kyc_docs_store_id").on(table.storeId),
+    documentTypeIndex: (0, pg_core_1.index)("idx_kyc_docs_type").on(table.documentType),
+    verificationStatusIndex: (0, pg_core_1.index)("idx_kyc_docs_verification_status").on(table.verificationStatus),
+    scheduledDeletionIndex: (0, pg_core_1.index)("idx_kyc_docs_scheduled_deletion").on(table.scheduledDeletionDate),
+}));
+// KYC Analytics - Track KYC metrics and analytics per store
+exports.kycAnalytics = (0, pg_core_1.pgTable)("kyc_analytics", {
+    id: (0, pg_core_1.text)("id")
+        .primaryKey()
+        .$defaultFn(() => (0, cuid2_1.createId)()),
+    storeId: (0, pg_core_1.text)("store_id").notNull().unique(),
+    // Verification Statistics
+    totalVerifications: (0, pg_core_1.integer)("total_verifications").notNull().default(0),
+    approvedVerifications: (0, pg_core_1.integer)("approved_verifications")
+        .notNull()
+        .default(0),
+    rejectedVerifications: (0, pg_core_1.integer)("rejected_verifications")
+        .notNull()
+        .default(0),
+    pendingVerifications: (0, pg_core_1.integer)("pending_verifications").notNull().default(0),
+    // Success Rates
+    approvalRate: (0, pg_core_1.decimal)("approval_rate", { precision: 5, scale: 2 }), // percentage
+    rejectionRate: (0, pg_core_1.decimal)("rejection_rate", { precision: 5, scale: 2 }),
+    averageVerificationTime: (0, pg_core_1.integer)("average_verification_time"), // minutes
+    // Risk Distribution
+    lowRiskCount: (0, pg_core_1.integer)("low_risk_count").notNull().default(0),
+    mediumRiskCount: (0, pg_core_1.integer)("medium_risk_count").notNull().default(0),
+    highRiskCount: (0, pg_core_1.integer)("high_risk_count").notNull().default(0),
+    criticalRiskCount: (0, pg_core_1.integer)("critical_risk_count").notNull().default(0),
+    // Tier Distribution
+    tier0Count: (0, pg_core_1.integer)("tier0_count").notNull().default(0),
+    tier1Count: (0, pg_core_1.integer)("tier1_count").notNull().default(0),
+    tier2Count: (0, pg_core_1.integer)("tier2_count").notNull().default(0),
+    tier3Count: (0, pg_core_1.integer)("tier3_count").notNull().default(0),
+    tier4Count: (0, pg_core_1.integer)("tier4_count").notNull().default(0),
+    // Document Statistics
+    totalDocumentsUploaded: (0, pg_core_1.integer)("total_documents_uploaded")
+        .notNull()
+        .default(0),
+    averageDocumentsPerVerification: (0, pg_core_1.decimal)("average_documents_per_verification", { precision: 5, scale: 2 }),
+    // Compliance Statistics
+    amlScreeningsCompleted: (0, pg_core_1.integer)("aml_screenings_completed")
+        .notNull()
+        .default(0),
+    sanctionsMatchesFound: (0, pg_core_1.integer)("sanctions_matches_found")
+        .notNull()
+        .default(0),
+    pepMatchesFound: (0, pg_core_1.integer)("pep_matches_found").notNull().default(0),
+    // Fraud Indicators
+    fraudSuspectedCount: (0, pg_core_1.integer)("fraud_suspected_count").notNull().default(0),
+    duplicateDetectedCount: (0, pg_core_1.integer)("duplicate_detected_count")
+        .notNull()
+        .default(0),
+    // Performance Metrics
+    averageConfidenceScore: (0, pg_core_1.decimal)("average_confidence_score", {
+        precision: 5,
+        scale: 2,
+    }),
+    averageRiskScore: (0, pg_core_1.decimal)("average_risk_score", { precision: 5, scale: 2 }),
+    // Time-based Metrics
+    verificationsThisMonth: (0, pg_core_1.integer)("verifications_this_month")
+        .notNull()
+        .default(0),
+    verificationsLastMonth: (0, pg_core_1.integer)("verifications_last_month")
+        .notNull()
+        .default(0),
+    lastCalculatedAt: (0, pg_core_1.timestamp)("last_calculated_at", { withTimezone: true }),
+    createdAt: (0, pg_core_1.timestamp)("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+    updatedAt: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+}, (table) => ({
+    storeIdIndex: (0, pg_core_1.index)("idx_kyc_analytics_store_id").on(table.storeId),
+}));
+// KYC Webhooks Log - Track all Didit webhook events
+exports.kycWebhooksLog = (0, pg_core_1.pgTable)("kyc_webhooks_log", {
+    id: (0, pg_core_1.text)("id")
+        .primaryKey()
+        .$defaultFn(() => (0, cuid2_1.createId)()),
+    diditSessionId: (0, pg_core_1.text)("didit_session_id"),
+    storeId: (0, pg_core_1.text)("store_id"),
+    kycId: (0, pg_core_1.text)("kyc_id").references(() => exports.storeKyc.id),
+    // Webhook Event Details
+    eventType: (0, pg_core_1.varchar)("event_type", { length: 50 })
+        .notNull()
+        .$type(),
+    webhookPayload: (0, pg_core_1.jsonb)("webhook_payload")
+        .notNull()
+        .$type(),
+    // Processing Status
+    processingStatus: (0, pg_core_1.varchar)("processing_status", { length: 30 })
+        .notNull()
+        .default("PENDING")
+        .$type(),
+    processedAt: (0, pg_core_1.timestamp)("processed_at", { withTimezone: true }),
+    failureReason: (0, pg_core_1.text)("failure_reason"),
+    retryCount: (0, pg_core_1.integer)("retry_count").notNull().default(0),
+    maxRetriesReached: (0, pg_core_1.boolean)("max_retries_reached").notNull().default(false),
+    // Request Details
+    requestHeaders: (0, pg_core_1.jsonb)("request_headers").$type(),
+    requestIp: (0, pg_core_1.varchar)("request_ip", { length: 45 }),
+    signatureValid: (0, pg_core_1.boolean)("signature_valid"),
+    createdAt: (0, pg_core_1.timestamp)("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+}, (table) => ({
+    sessionIdIndex: (0, pg_core_1.index)("idx_kyc_webhooks_session_id").on(table.diditSessionId),
+    kycIdIndex: (0, pg_core_1.index)("idx_kyc_webhooks_kyc_id").on(table.kycId),
+    processingStatusIndex: (0, pg_core_1.index)("idx_kyc_webhooks_processing_status").on(table.processingStatus),
+    createdAtIndex: (0, pg_core_1.index)("idx_kyc_webhooks_created_at").on(table.createdAt),
+}));
+// Relations
+exports.storeKycRelations = (0, drizzle_orm_1.relations)(exports.storeKyc, ({ one, many }) => ({
+    compliance: one(compliance_schema_1.storeCompliance, {
+        fields: [exports.storeKyc.storeId],
+        references: [compliance_schema_1.storeCompliance.storeId],
+    }),
+    history: many(exports.kycVerificationHistory),
+    documents: many(exports.kycDocuments),
+    webhooks: many(exports.kycWebhooksLog),
+}));
+exports.kycVerificationHistoryRelations = (0, drizzle_orm_1.relations)(exports.kycVerificationHistory, ({ one }) => ({
+    kyc: one(exports.storeKyc, {
+        fields: [exports.kycVerificationHistory.kycId],
+        references: [exports.storeKyc.id],
+    }),
+}));
+exports.kycDocumentsRelations = (0, drizzle_orm_1.relations)(exports.kycDocuments, ({ one }) => ({
+    kyc: one(exports.storeKyc, {
+        fields: [exports.kycDocuments.kycId],
+        references: [exports.storeKyc.id],
+    }),
+}));
+exports.kycWebhooksLogRelations = (0, drizzle_orm_1.relations)(exports.kycWebhooksLog, ({ one }) => ({
+    kyc: one(exports.storeKyc, {
+        fields: [exports.kycWebhooksLog.kycId],
+        references: [exports.storeKyc.id],
+    }),
+}));
+exports.kycAnalyticsRelations = (0, drizzle_orm_1.relations)(exports.kycAnalytics, ({ one }) => ({
+    compliance: one(compliance_schema_1.storeCompliance, {
+        fields: [exports.kycAnalytics.storeId],
+        references: [compliance_schema_1.storeCompliance.storeId],
+    }),
+}));