@dotdo/postgres 0.1.0

package/dist/retention/policy.js

@@ -0,0 +1,472 @@
+/**
+ * Retention Policy Management
+ * Task: postgres-nau - Retention and purge policies
+ *
+ * Implements comprehensive data retention and purge policies for time travel data:
+ * - Configurable retention per data type
+ * - Legal hold capability
+ * - GDPR right-to-erasure support
+ * - Audit trail for deletions
+ * - Cascade policies across related data
+ * - Regulatory compliance templates
+ */
+/**
+ * Pre-defined compliance profiles
+ */
+export const COMPLIANCE_PROFILES = {
+    gdpr: {
+        framework: 'gdpr',
+        name: 'GDPR Compliance',
+        defaultRetention: {
+            wal: { type: 'time', days: 30 },
+            iceberg: { type: 'time', days: 365 },
+            snapshots: { type: 'time', days: 30 },
+            custom: { type: 'time', days: 90 },
+        },
+        maximumRetention: {
+            wal: 90,
+            iceberg: 2555, // 7 years
+            snapshots: 90,
+            custom: 365,
+        },
+        requireAuditTrail: true,
+    },
+    sox: {
+        framework: 'sox',
+        name: 'SOX Compliance',
+        defaultRetention: {
+            wal: { type: 'time', days: 2555 }, // 7 years
+            iceberg: { type: 'time', days: 2555 },
+            snapshots: { type: 'time', days: 2555 },
+            custom: { type: 'time', days: 2555 },
+        },
+        minimumRetention: {
+            wal: 2555,
+            iceberg: 2555,
+            snapshots: 2555,
+            custom: 2555,
+        },
+        requireAuditTrail: true,
+        requireLegalHold: true,
+    },
+    hipaa: {
+        framework: 'hipaa',
+        name: 'HIPAA Compliance',
+        defaultRetention: {
+            wal: { type: 'time', days: 2190 }, // 6 years
+            iceberg: { type: 'time', days: 2190 },
+            snapshots: { type: 'time', days: 2190 },
+            custom: { type: 'time', days: 2190 },
+        },
+        minimumRetention: {
+            wal: 2190,
+            iceberg: 2190,
+            snapshots: 2190,
+            custom: 2190,
+        },
+        requireAuditTrail: true,
+        requireLegalHold: true,
+    },
+};
+/**
+ * Retention Policy Manager
+ *
+ * Manages retention policies for different data types with support for
+ * legal holds, GDPR erasure, and compliance frameworks.
+ *
+ * @example
+ * ```typescript
+ * const policyManager = new RetentionPolicy()
+ *
+ * // Set a time-based policy for snapshots
+ * policyManager.setPolicy('snapshots', { type: 'time', days: 30 })
+ *
+ * // Set a count-based policy for WAL
+ * policyManager.setPolicy('wal', { type: 'count', snapshots: 100 })
+ *
+ * // Set a size-based policy
+ * policyManager.setPolicy('iceberg', { type: 'size', maxGB: 10 })
+ *
+ * // Evaluate what should be purged
+ * const items = [
+ *   { id: '1', table: 'snapshots', createdAt: Date.now() - 40 * 24 * 60 * 60 * 1000, sizeBytes: 1000 },
+ *   { id: '2', table: 'snapshots', createdAt: Date.now() - 20 * 24 * 60 * 60 * 1000, sizeBytes: 1000 },
+ * ]
+ * const evaluation = policyManager.evaluate('snapshots', items)
+ * console.log(`${evaluation.toPurge.length} items to purge`)
+ *
+ * // Apply compliance profile
+ * policyManager.applyComplianceProfile('gdpr')
+ * ```
+ */
+export class RetentionPolicy {
+    policies = new Map();
+    legalHolds = new Map();
+    erasureRequests = new Map();
+    auditLog = [];
+    complianceProfile;
+    /**
+     * Set retention policy for a table/data type
+     */
+    setPolicy(table, policy) {
+        // Validate against compliance profile if set
+        if (this.complianceProfile) {
+            this.validatePolicyAgainstCompliance(table, policy);
+        }
+        this.policies.set(table, policy);
+    }
+    /**
+     * Get retention policy for a table/data type
+     */
+    getPolicy(table) {
+        return this.policies.get(table);
+    }
+    /**
+     * List all configured policies
+     */
+    listPolicies() {
+        return new Map(this.policies);
+    }
+    /**
+     * Set legal hold for a table
+     */
+    setLegalHold(table, hold) {
+        this.legalHolds.set(table, {
+            ...hold,
+            appliedAt: hold.appliedAt ?? Date.now(),
+        });
+    }
+    /**
+     * Get legal hold for a table
+     */
+    getLegalHold(table) {
+        return this.legalHolds.get(table);
+    }
+    /**
+     * Check if legal hold is active for a table
+     */
+    isLegalHoldActive(table) {
+        const hold = this.legalHolds.get(table);
+        if (!hold || !hold.enabled) {
+            return false;
+        }
+        // Check if legal hold has expired
+        if (hold.expiresAt && Date.now() > hold.expiresAt) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Apply a compliance profile
+     */
+    applyComplianceProfile(profileName) {
+        const profile = COMPLIANCE_PROFILES[profileName];
+        if (!profile) {
+            throw new Error(`Unknown compliance profile: ${profileName}`);
+        }
+        this.complianceProfile = profile;
+        // Apply default retention policies
+        for (const [dataType, policy] of Object.entries(profile.defaultRetention)) {
+            this.policies.set(dataType, policy);
+        }
+    }
+    /**
+     * Get current compliance profile
+     */
+    getComplianceProfile() {
+        return this.complianceProfile;
+    }
+    /**
+     * Validate a policy against compliance requirements
+     */
+    validatePolicyAgainstCompliance(table, policy) {
+        if (!this.complianceProfile) {
+            return;
+        }
+        const minRetention = this.complianceProfile.minimumRetention?.[table];
+        const maxRetention = this.complianceProfile.maximumRetention?.[table];
+        // Convert policy to days for comparison
+        let policyDays;
+        if (policy.type === 'time') {
+            policyDays = policy.days;
+        }
+        else if (policy.type === 'combined' && policy.time) {
+            policyDays = policy.time.days;
+        }
+        if (policyDays !== undefined) {
+            if (minRetention && policyDays < minRetention) {
+                throw new Error(`Policy for ${table} violates minimum retention of ${minRetention} days (${this.complianceProfile.framework})`);
+            }
+            if (maxRetention && policyDays > maxRetention) {
+                throw new Error(`Policy for ${table} violates maximum retention of ${maxRetention} days (${this.complianceProfile.framework})`);
+            }
+        }
+    }
+    /**
+     * Evaluate items against retention policy
+     */
+    evaluate(table, items) {
+        const policy = this.policies.get(table);
+        if (!policy) {
+            // No policy set - retain everything
+            return {
+                toPurge: [],
+                toRetain: items,
+                reasons: new Map(),
+                legalHoldActive: false,
+            };
+        }
+        // Check for legal hold
+        if (this.isLegalHoldActive(table)) {
+            const reasons = new Map(items.map((item) => [item.id, 'Legal hold active']));
+            return {
+                toPurge: [],
+                toRetain: items,
+                reasons,
+                legalHoldActive: true,
+            };
+        }
+        return this.evaluatePolicy(table, policy, items);
+    }
+    /**
+     * Evaluate items against a specific policy
+     */
+    evaluatePolicy(table, policy, items) {
+        const toPurge = [];
+        const toRetain = [];
+        const reasons = new Map();
+        const now = Date.now();
+        switch (policy.type) {
+            case 'time': {
+                const retentionMs = policy.days * 24 * 60 * 60 * 1000;
+                for (const item of items) {
+                    const age = now - item.createdAt;
+                    if (age > retentionMs) {
+                        toPurge.push(item);
+                        reasons.set(item.id, `Older than ${policy.days} days`);
+                    }
+                    else {
+                        toRetain.push(item);
+                        reasons.set(item.id, `Within ${policy.days} day retention`);
+                    }
+                }
+                break;
+            }
+            case 'count': {
+                // Sort by creation time
+                const sorted = [...items].sort((a, b) => {
+                    return policy.keepNewest !== false ? b.createdAt - a.createdAt : a.createdAt - b.createdAt;
+                });
+                for (let i = 0; i < sorted.length; i++) {
+                    const item = sorted[i];
+                    if (!item)
+                        continue;
+                    if (i < policy.snapshots) {
+                        toRetain.push(item);
+                        reasons.set(item.id, `Within top ${policy.snapshots} snapshots`);
+                    }
+                    else {
+                        toPurge.push(item);
+                        reasons.set(item.id, `Exceeds ${policy.snapshots} snapshot limit`);
+                    }
+                }
+                break;
+            }
+            case 'size': {
+                const maxBytes = policy.maxGB * 1024 * 1024 * 1024;
+                const sorted = [...items].sort((a, b) => {
+                    return policy.evictOldestFirst !== false ? a.createdAt - b.createdAt : b.createdAt - a.createdAt;
+                });
+                let cumulativeSize = 0;
+                for (const item of sorted) {
+                    if (cumulativeSize + item.sizeBytes <= maxBytes) {
+                        toRetain.push(item);
+                        cumulativeSize += item.sizeBytes;
+                        reasons.set(item.id, `Within ${policy.maxGB}GB size limit`);
+                    }
+                    else {
+                        toPurge.push(item);
+                        reasons.set(item.id, `Exceeds ${policy.maxGB}GB size limit`);
+                    }
+                }
+                break;
+            }
+            case 'combined': {
+                // Apply all component policies and keep intersection
+                let currentToPurge = new Set(items.map((i) => i.id));
+                let currentToRetain = new Set();
+                if (policy.time) {
+                    const timePolicy = { type: 'time', ...policy.time };
+                    const result = this.evaluatePolicy(table, timePolicy, items);
+                    currentToRetain = new Set(result.toRetain.map((i) => i.id));
+                    currentToPurge = new Set([...currentToPurge].filter((id) => !currentToRetain.has(id)));
+                }
+                if (policy.count) {
+                    const countPolicy = { type: 'count', ...policy.count };
+                    const result = this.evaluatePolicy(table, countPolicy, items);
+                    const countRetain = new Set(result.toRetain.map((i) => i.id));
+                    currentToRetain = new Set([...currentToRetain].filter((id) => countRetain.has(id)));
+                    currentToPurge = new Set(items.map((i) => i.id).filter((id) => !currentToRetain.has(id)));
+                }
+                if (policy.size) {
+                    const sizePolicy = { type: 'size', ...policy.size };
+                    const result = this.evaluatePolicy(table, sizePolicy, items);
+                    const sizeRetain = new Set(result.toRetain.map((i) => i.id));
+                    currentToRetain = new Set([...currentToRetain].filter((id) => sizeRetain.has(id)));
+                    currentToPurge = new Set(items.map((i) => i.id).filter((id) => !currentToRetain.has(id)));
+                }
+                for (const item of items) {
+                    if (currentToPurge.has(item.id)) {
+                        toPurge.push(item);
+                        reasons.set(item.id, 'Failed combined retention criteria');
+                    }
+                    else {
+                        toRetain.push(item);
+                        reasons.set(item.id, 'Meets combined retention criteria');
+                    }
+                }
+                break;
+            }
+        }
+        return {
+            toPurge,
+            toRetain,
+            reasons,
+            legalHoldActive: false,
+        };
+    }
+    /**
+     * Create a GDPR erasure request
+     */
+    createErasureRequest(subjectId, scope, requestedBy) {
+        const now = Date.now();
+        const request = {
+            id: `erasure-${now}-${Math.random().toString(36).substring(7)}`,
+            subjectId,
+            requestedAt: now,
+            deadline: now + 72 * 60 * 60 * 1000, // 72 hours
+            scope,
+            status: 'pending',
+        };
+        if (requestedBy !== undefined) {
+            request.requestedBy = requestedBy;
+        }
+        this.erasureRequests.set(request.id, request);
+        return request;
+    }
+    /**
+     * Get erasure request by ID
+     */
+    getErasureRequest(requestId) {
+        return this.erasureRequests.get(requestId);
+    }
+    /**
+     * List all erasure requests
+     */
+    listErasureRequests(status) {
+        const requests = Array.from(this.erasureRequests.values());
+        if (status) {
+            return requests.filter((r) => r.status === status);
+        }
+        return requests;
+    }
+    /**
+     * Update erasure request status
+     */
+    updateErasureRequest(requestId, update) {
+        const request = this.erasureRequests.get(requestId);
+        if (!request) {
+            throw new Error(`Erasure request not found: ${requestId}`);
+        }
+        Object.assign(request, update);
+    }
+    /**
+     * Add an audit entry
+     */
+    addAuditEntry(entry) {
+        const auditEntry = {
+            id: `audit-${Date.now()}-${Math.random().toString(36).substring(7)}`,
+            timestamp: Date.now(),
+            ...entry,
+        };
+        this.auditLog.push(auditEntry);
+    }
+    /**
+     * Get audit trail
+     */
+    getAuditTrail(filter) {
+        let entries = [...this.auditLog];
+        if (filter?.table) {
+            entries = entries.filter((e) => e.table === filter.table);
+        }
+        if (filter?.operation) {
+            entries = entries.filter((e) => e.operation === filter.operation);
+        }
+        if (filter?.startDate) {
+            entries = entries.filter((e) => e.timestamp >= filter.startDate);
+        }
+        if (filter?.endDate) {
+            entries = entries.filter((e) => e.timestamp <= filter.endDate);
+        }
+        return entries.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Generate compliance report
+     */
+    generateComplianceReport() {
+        const now = Date.now();
+        const issues = [];
+        let complianceStatus = 'compliant';
+        // Check for overdue erasure requests
+        const activeRequests = this.listErasureRequests('pending').concat(this.listErasureRequests('in_progress'));
+        const overdueRequests = activeRequests.filter((r) => now > r.deadline);
+        if (overdueRequests.length > 0) {
+            complianceStatus = 'violation';
+            issues.push(`${overdueRequests.length} overdue GDPR erasure request(s)`);
+        }
+        // Check policies against compliance profile
+        if (this.complianceProfile) {
+            for (const [table, policy] of this.policies) {
+                try {
+                    this.validatePolicyAgainstCompliance(table, policy);
+                }
+                catch (error) {
+                    complianceStatus = 'violation';
+                    issues.push(error instanceof Error ? error.message : String(error));
+                }
+            }
+        }
+        // Recent audit entries (last 30 days)
+        const thirtyDaysAgo = now - 30 * 24 * 60 * 60 * 1000;
+        const recentAuditEntries = this.getAuditTrail({ startDate: thirtyDaysAgo });
+        const result = {
+            policies: new Map(this.policies),
+            legalHolds: new Map(this.legalHolds),
+            activeErasureRequests: activeRequests,
+            overdueErasureRequests: overdueRequests,
+            recentAuditEntries,
+            complianceStatus,
+            issues,
+        };
+        if (this.complianceProfile !== undefined) {
+            result.profile = this.complianceProfile;
+        }
+        return result;
+    }
+}
+/**
+ * Create a retention policy with a compliance profile
+ *
+ * @example
+ * ```typescript
+ * const policy = createRetentionPolicy('gdpr')
+ * ```
+ */
+export function createRetentionPolicy(complianceProfile) {
+    const policy = new RetentionPolicy();
+    if (complianceProfile) {
+        policy.applyComplianceProfile(complianceProfile);
+    }
+    return policy;
+}
+//# sourceMappingURL=policy.js.map

package/dist/retention/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/retention/policy.ts"],"names":[],"mappings":"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"}

package/dist/retention/purger.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Automatic Purger
+ * Task: postgres-nau - Retention and purge policies
+ *
+ * Implements automatic purging with support for:
+ * - Scheduled purge operations
+ * - Soft delete, hard delete, cryptographic erasure
+ * - Cascade delete for related data
+ * - Audit logging
+ * - GDPR erasure request processing
+ */
+import type { RetentionPolicy, PurgeCandidate, PurgeOperation } from './policy';
+export type { AuditEntry, ErasureRequest } from './policy';
+/**
+ * Purge result
+ */
+export interface PurgeResult {
+    /** Whether the purge was successful */
+    success: boolean;
+    /** Table that was purged */
+    table: string;
+    /** Operation type */
+    operation: PurgeOperation;
+    /** Number of items purged */
+    itemsPurged: number;
+    /** Bytes freed */
+    bytesFreed: number;
+    /** Duration of purge operation in milliseconds */
+    durationMs: number;
+    /** Associated audit entry ID */
+    auditEntryId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Purger configuration
+ */
+export interface PurgerConfig {
+    /** Retention policy manager */
+    policy: RetentionPolicy;
+    /** Default purge operation type */
+    defaultOperation?: PurgeOperation;
+    /** Whether to enable automatic purging */
+    autoEnabled?: boolean;
+    /** Purge interval in milliseconds (default: 1 hour) */
+    purgeIntervalMs?: number;
+    /** Dry run mode - report what would be purged without actually purging */
+    dryRun?: boolean;
+    /** Maximum items to purge per batch (to avoid long operations) */
+    maxBatchSize?: number;
+    /** Callback for purge events */
+    onPurge?: (result: PurgeResult) => void;
+    /** Function to actually delete items from storage */
+    deleteHandler: (table: string, items: PurgeCandidate[], operation: PurgeOperation) => Promise<void>;
+    /** Function to fetch items for evaluation */
+    fetchHandler: (table: string) => Promise<PurgeCandidate[]>;
+    /** Optional: Cascade delete handler for related data */
+    cascadeHandler?: (table: string, items: PurgeCandidate[]) => Promise<string[]>;
+}
+/**
+ * Purge statistics
+ */
+export interface PurgeStats {
+    /** Total purge operations */
+    totalPurges: number;
+    /** Successful purge operations */
+    successfulPurges: number;
+    /** Failed purge operations */
+    failedPurges: number;
+    /** Total items purged */
+    totalItemsPurged: number;
+    /** Total bytes freed */
+    totalBytesFreed: number;
+    /** Last purge timestamp */
+    lastPurgeAt: number | null;
+    /** Last purge result */
+    lastPurgeResult: PurgeResult | null;
+    /** Purges by operation type */
+    purgesByOperation: Record<PurgeOperation, number>;
+}
+/**
+ * Automatic Purger
+ *
+ * Manages automatic purging of data based on retention policies.
+ * Supports soft delete, hard delete, cryptographic erasure, and cascade delete.
+ *
+ * @example
+ * ```typescript
+ * const policy = new RetentionPolicy()
+ * policy.setPolicy('snapshots', { type: 'time', days: 30 })
+ *
+ * const purger = new AutoPurger({
+ *   policy,
+ *   fetchHandler: async (table) => {
+ *     // Fetch items from your storage
+ *     return items
+ *   },
+ *   deleteHandler: async (table, items, operation) => {
+ *     // Delete items from your storage
+ *     for (const item of items) {
+ *       await storage.delete(item.id)
+ *     }
+ *   },
+ * })
+ *
+ * // Start automatic purging
+ * purger.start()
+ *
+ * // Manual purge
+ * const result = await purger.purge('snapshots')
+ * console.log(`Purged ${result.itemsPurged} items`)
+ * ```
+ */
+export declare class AutoPurger {
+    private config;
+    private stats;
+    private purgeInterval;
+    private purgeInProgress;
+    constructor(config: PurgerConfig);
+    /**
+     * Start automatic purging
+     */
+    start(): void;
+    /**
+     * Stop automatic purging
+     */
+    stop(): void;
+    /**
+     * Check if auto purge is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get purge statistics
+     */
+    getStats(): PurgeStats;
+    /**
+     * Purge all tables with configured policies
+     */
+    purgeAll(): Promise<PurgeResult[]>;
+    /**
+     * Purge a specific table
+     */
+    purge(table: string, operation?: PurgeOperation): Promise<PurgeResult>;
+    /**
+     * Process GDPR erasure request
+     *
+     * Performs hard delete or cryptographic erasure for data subject
+     */
+    processErasureRequest(requestId: string, operation?: 'hard_delete' | 'cryptographic_erasure'): Promise<{
+        success: boolean;
+        tablesProcessed: string[];
+        itemsErased: number;
+        error?: string;
+    }>;
+    /**
+     * Process all pending erasure requests
+     */
+    processAllErasureRequests(): Promise<Array<{
+        requestId: string;
+        success: boolean;
+        tablesProcessed: string[];
+        itemsErased: number;
+        error?: string;
+    }>>;
+    /**
+     * Get next purge time
+     */
+    getNextPurgeIn(): number | null;
+}
+/**
+ * Create an auto purger with the specified configuration
+ *
+ * @example
+ * ```typescript
+ * const purger = createAutoPurger({
+ *   policy,
+ *   fetchHandler: async (table) => items,
+ *   deleteHandler: async (table, items, operation) => {
+ *     // Delete implementation
+ *   },
+ * })
+ *
+ * purger.start()
+ * ```
+ */
+export declare function createAutoPurger(config: PurgerConfig): AutoPurger;
+//# sourceMappingURL=purger.d.ts.map

package/dist/retention/purger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purger.d.ts","sourceRoot":"","sources":["../../src/retention/purger.ts"],"names":[],"mappings":"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"}