@nice2dev/ui-tools 1.0.10

package/dist/db-admin.d.ts

@@ -0,0 +1,699 @@
+/**
+ * @file db-admin.ts
+ * @module @nice2dev/ui-tools/db-admin
+ * @description PRO-10.5 — Database Administration types
+ *
+ * Connection pool monitor, query monitor, lock detection, performance,
+ * backup/recovery, user management, audit logs.
+ */
+/** Connection pool statistics */
+export interface ConnectionPoolStats {
+    readonly connectionId: string;
+    readonly poolName: string;
+    readonly minSize: number;
+    readonly maxSize: number;
+    readonly activeConnections: number;
+    readonly idleConnections: number;
+    readonly waitingRequests: number;
+    readonly totalConnectionsCreated: number;
+    readonly totalConnectionsClosed: number;
+    readonly averageAcquireTime: number;
+    readonly maxAcquireTime: number;
+    readonly averageUsageTime: number;
+    readonly lastUpdated: Date;
+}
+/** Individual pool connection */
+export interface PoolConnection {
+    readonly id: string;
+    readonly state: 'active' | 'idle' | 'validating' | 'evicting';
+    readonly createdAt: Date;
+    readonly lastUsedAt: Date;
+    readonly lastValidatedAt?: Date;
+    readonly useCount: number;
+    readonly currentQuery?: string;
+    readonly clientInfo?: string;
+    readonly remoteAddress?: string;
+}
+/** Pool health status */
+export interface PoolHealthStatus {
+    readonly healthy: boolean;
+    readonly utilizationPercent: number;
+    readonly waitQueueLength: number;
+    readonly averageResponseTime: number;
+    readonly errorRate: number;
+    readonly issues: readonly PoolIssue[];
+}
+/** Pool issue */
+export interface PoolIssue {
+    readonly severity: 'warning' | 'error' | 'critical';
+    readonly type: 'exhaustion' | 'leak' | 'slow_acquire' | 'connection_errors' | 'validation_failures';
+    readonly message: string;
+    readonly recommendation: string;
+}
+/** Active query */
+export interface ActiveQuery {
+    readonly pid: number | string;
+    readonly queryId?: string;
+    readonly database: string;
+    readonly username: string;
+    readonly applicationName?: string;
+    readonly clientAddress?: string;
+    readonly clientPort?: number;
+    readonly state: QueryState;
+    readonly query: string;
+    readonly queryStart: Date;
+    readonly duration: number;
+    readonly waitEventType?: string;
+    readonly waitEvent?: string;
+    readonly transactionId?: string;
+    readonly blocker?: number | string;
+    readonly cpuTime?: number;
+    readonly memoryUsage?: number;
+}
+/** Query state */
+export type QueryState = 'active' | 'idle' | 'idle_in_transaction' | 'idle_in_transaction_aborted' | 'fastpath_function_call' | 'disabled' | 'running' | 'sleeping' | 'suspended' | 'background';
+/** Query statistics */
+export interface QueryStatistics {
+    readonly queryHash: string;
+    readonly normalizedQuery: string;
+    readonly calls: number;
+    readonly totalTime: number;
+    readonly minTime: number;
+    readonly maxTime: number;
+    readonly meanTime: number;
+    readonly stddevTime: number;
+    readonly rows: number;
+    readonly sharedBlksHit?: number;
+    readonly sharedBlksRead?: number;
+    readonly sharedBlksDirtied?: number;
+    readonly sharedBlksWritten?: number;
+    readonly tempBlksRead?: number;
+    readonly tempBlksWritten?: number;
+    readonly blkReadTime?: number;
+    readonly blkWriteTime?: number;
+}
+/** Query kill options */
+export interface QueryKillOptions {
+    readonly pid: number | string;
+    readonly signal: 'cancel' | 'terminate';
+    readonly cascade: boolean;
+    readonly reason?: string;
+}
+/** Database lock */
+export interface DbLock {
+    readonly lockId: string;
+    readonly pid: number | string;
+    readonly database: string;
+    readonly schema?: string;
+    readonly relation?: string;
+    readonly lockType: LockType;
+    readonly lockMode: LockMode;
+    readonly granted: boolean;
+    readonly waitStart?: Date;
+    readonly duration?: number;
+    readonly query?: string;
+    readonly transactionId?: string;
+    readonly blockedBy?: readonly number[];
+    readonly blocking?: readonly number[];
+}
+/** Lock type */
+export type LockType = 'relation' | 'extend' | 'frozenid' | 'page' | 'tuple' | 'transactionid' | 'virtualxid' | 'speculative_token' | 'object' | 'userlock' | 'advisory' | 'applytransaction';
+/** Lock mode */
+export type LockMode = 'AccessShareLock' | 'RowShareLock' | 'RowExclusiveLock' | 'ShareUpdateExclusiveLock' | 'ShareLock' | 'ShareRowExclusiveLock' | 'ExclusiveLock' | 'AccessExclusiveLock' | 'IS' | 'IX' | 'S' | 'U' | 'X';
+/** Deadlock info */
+export interface DeadlockInfo {
+    readonly id: string;
+    readonly detectedAt: Date;
+    readonly participants: readonly DeadlockParticipant[];
+    readonly victim: number | string;
+    readonly graph: DeadlockGraph;
+}
+/** Deadlock participant */
+export interface DeadlockParticipant {
+    readonly pid: number | string;
+    readonly query: string;
+    readonly lockType: LockType;
+    readonly lockMode: LockMode;
+    readonly waitingFor: number | string;
+    readonly holdingLock?: string;
+}
+/** Deadlock graph */
+export interface DeadlockGraph {
+    readonly nodes: readonly {
+        id: string;
+        label: string;
+    }[];
+    readonly edges: readonly {
+        from: string;
+        to: string;
+        label: string;
+    }[];
+}
+/** Lock conflict detection */
+export interface LockConflict {
+    readonly blockerPid: number | string;
+    readonly blockerQuery: string;
+    readonly blockerStartTime: Date;
+    readonly blockedPid: number | string;
+    readonly blockedQuery: string;
+    readonly blockedWaitTime: number;
+    readonly lockType: LockType;
+    readonly lockMode: LockMode;
+    readonly relation?: string;
+}
+/** Slow query entry */
+export interface SlowQueryEntry {
+    readonly id: string;
+    readonly query: string;
+    readonly normalizedQuery: string;
+    readonly database: string;
+    readonly username: string;
+    readonly applicationName?: string;
+    readonly startTime: Date;
+    readonly duration: number;
+    readonly rowsAffected: number;
+    readonly rowsExamined?: number;
+    readonly bytesReceived?: number;
+    readonly bytesSent?: number;
+    readonly lockTime?: number;
+    readonly tmpTables?: number;
+    readonly tmpDiskTables?: number;
+    readonly fullScan: boolean;
+    readonly fullJoin: boolean;
+    readonly plan?: string;
+    readonly parameters?: readonly unknown[];
+}
+/** Slow query analysis */
+export interface SlowQueryAnalysis {
+    readonly query: string;
+    readonly normalizedQuery: string;
+    readonly occurrences: number;
+    readonly totalDuration: number;
+    readonly avgDuration: number;
+    readonly maxDuration: number;
+    readonly minDuration: number;
+    readonly p50Duration: number;
+    readonly p95Duration: number;
+    readonly p99Duration: number;
+    readonly suggestions: readonly QueryOptimizationSuggestion[];
+    readonly samplePlan?: string;
+}
+/** Query optimization suggestion */
+export interface QueryOptimizationSuggestion {
+    readonly type: 'index' | 'rewrite' | 'schema' | 'parameter' | 'hint';
+    readonly severity: 'low' | 'medium' | 'high';
+    readonly description: string;
+    readonly suggestedChange?: string;
+    readonly estimatedImprovement?: string;
+}
+/** Index recommendation */
+export interface IndexRecommendation {
+    readonly id: string;
+    readonly tableName: string;
+    readonly schema: string;
+    readonly columns: readonly string[];
+    readonly indexType: 'btree' | 'hash' | 'gin' | 'gist' | 'brin' | 'fulltext';
+    readonly isUnique: boolean;
+    readonly includeColumns?: readonly string[];
+    readonly predicate?: string;
+    readonly reason: string;
+    readonly affectedQueries: readonly string[];
+    readonly estimatedImprovement: number;
+    readonly estimatedSize: number;
+    readonly createStatement: string;
+    readonly priority: 'low' | 'medium' | 'high' | 'critical';
+}
+/** Unused index */
+export interface UnusedIndex {
+    readonly indexName: string;
+    readonly tableName: string;
+    readonly schema: string;
+    readonly columns: readonly string[];
+    readonly size: number;
+    readonly lastUsed?: Date;
+    readonly scanCount: number;
+    readonly fetchCount: number;
+    readonly readCount: number;
+    readonly recommendation: 'keep' | 'review' | 'drop';
+    readonly dropStatement: string;
+}
+/** Duplicate index */
+export interface DuplicateIndex {
+    readonly indexes: readonly string[];
+    readonly tableName: string;
+    readonly schema: string;
+    readonly columns: readonly string[];
+    readonly reason: string;
+    readonly keepIndex: string;
+    readonly dropStatements: readonly string[];
+}
+/** Index fragmentation */
+export interface IndexFragmentation {
+    readonly indexName: string;
+    readonly tableName: string;
+    readonly schema: string;
+    readonly fragmentationPercent: number;
+    readonly pageCount: number;
+    readonly avgPageDensity: number;
+    readonly recommendation: 'none' | 'reorganize' | 'rebuild';
+    readonly rebuildStatement: string;
+}
+/** Buffer cache statistics */
+export interface BufferCacheStats {
+    readonly totalBuffers: number;
+    readonly usedBuffers: number;
+    readonly freeBuffers: number;
+    readonly dirtyBuffers: number;
+    readonly pinnedBuffers: number;
+    readonly hitRatio: number;
+    readonly readRate: number;
+    readonly writeRate: number;
+    readonly checkpointRate: number;
+}
+/** Buffer cache by table */
+export interface TableBufferUsage {
+    readonly tableName: string;
+    readonly schema: string;
+    readonly buffersUsed: number;
+    readonly buffersPercent: number;
+    readonly heapBuffers: number;
+    readonly indexBuffers: number;
+    readonly toastBuffers: number;
+    readonly hitRatio: number;
+}
+/** Memory component stats */
+export interface MemoryComponentStats {
+    readonly component: string;
+    readonly used: number;
+    readonly free: number;
+    readonly max: number;
+    readonly utilizationPercent: number;
+}
+/** Replication status */
+export interface ReplicationStatus {
+    readonly role: 'primary' | 'standby' | 'master' | 'slave';
+    readonly state: 'streaming' | 'catchup' | 'backup' | 'disconnected' | 'potential';
+    readonly replicas: readonly ReplicaInfo[];
+    readonly lagWarningThreshold: number;
+    readonly lagCriticalThreshold: number;
+}
+/** Replica information */
+export interface ReplicaInfo {
+    readonly name: string;
+    readonly host: string;
+    readonly port: number;
+    readonly state: 'streaming' | 'catchup' | 'backup' | 'disconnected';
+    readonly receivedLsn?: string;
+    readonly replayedLsn?: string;
+    readonly writeLag?: number;
+    readonly flushLag?: number;
+    readonly replayLag?: number;
+    readonly lagBytes?: number;
+    readonly lagSeconds?: number;
+    readonly syncState?: 'async' | 'sync' | 'potential' | 'quorum';
+    readonly replicationSlot?: string;
+    readonly connectedSince?: Date;
+}
+/** Replication slot */
+export interface ReplicationSlot {
+    readonly name: string;
+    readonly plugin?: string;
+    readonly slotType: 'physical' | 'logical';
+    readonly database?: string;
+    readonly active: boolean;
+    readonly activePid?: number;
+    readonly restartLsn?: string;
+    readonly confirmedFlushLsn?: string;
+    readonly retainedWalBytes?: number;
+    readonly catalogXmin?: string;
+    readonly createdAt?: Date;
+}
+/** Backup schedule */
+export interface BackupSchedule {
+    readonly id: string;
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly type: BackupType;
+    readonly schedule: CronSchedule;
+    readonly retention: RetentionPolicy;
+    readonly destination: BackupDestination;
+    readonly options: BackupOptions;
+    readonly lastRun?: Date;
+    readonly lastStatus?: 'success' | 'failed' | 'running';
+    readonly nextRun?: Date;
+}
+/** Backup type */
+export type BackupType = 'full' | 'incremental' | 'differential' | 'transaction_log' | 'snapshot';
+/** Cron schedule */
+export interface CronSchedule {
+    readonly expression: string;
+    readonly timezone: string;
+    readonly description?: string;
+}
+/** Retention policy */
+export interface RetentionPolicy {
+    readonly type: 'count' | 'age' | 'size';
+    readonly value: number;
+    readonly unit?: 'days' | 'weeks' | 'months' | 'years' | 'gb';
+    readonly keepMonthly?: number;
+    readonly keepYearly?: number;
+}
+/** Backup destination */
+export interface BackupDestination {
+    readonly type: 'local' | 's3' | 'azure' | 'gcs' | 'sftp' | 'nfs';
+    readonly path: string;
+    readonly bucket?: string;
+    readonly region?: string;
+    readonly credentials?: string;
+    readonly compression?: 'none' | 'gzip' | 'lz4' | 'zstd';
+    readonly encryption?: EncryptionConfig;
+}
+/** Encryption configuration */
+export interface EncryptionConfig {
+    readonly algorithm: 'aes-256-cbc' | 'aes-256-gcm';
+    readonly keyId?: string;
+    readonly keyFile?: string;
+}
+/** Backup options */
+export interface BackupOptions {
+    readonly parallel?: number;
+    readonly compressionLevel?: number;
+    readonly excludeTables?: readonly string[];
+    readonly includeTables?: readonly string[];
+    readonly excludeSchemas?: readonly string[];
+    readonly dataOnly?: boolean;
+    readonly schemaOnly?: boolean;
+    readonly noOwner?: boolean;
+    readonly noPrivileges?: boolean;
+    readonly format?: 'custom' | 'directory' | 'tar' | 'plain';
+    readonly checksum?: boolean;
+    readonly verify?: boolean;
+}
+/** Backup result */
+export interface BackupResult {
+    readonly id: string;
+    readonly scheduleId?: string;
+    readonly type: BackupType;
+    readonly startTime: Date;
+    readonly endTime: Date;
+    readonly duration: number;
+    readonly status: 'success' | 'failed' | 'partial';
+    readonly size: number;
+    readonly compressedSize?: number;
+    readonly location: string;
+    readonly checksum?: string;
+    readonly error?: string;
+    readonly tablesBackedUp?: number;
+    readonly rowsBackedUp?: number;
+}
+/** Recovery point */
+export interface RecoveryPoint {
+    readonly id: string;
+    readonly type: 'backup' | 'snapshot' | 'wal' | 'transaction_log';
+    readonly timestamp: Date;
+    readonly lsn?: string;
+    readonly backupId?: string;
+    readonly label?: string;
+    readonly isConsistent: boolean;
+    readonly databases?: readonly string[];
+}
+/** Recovery options */
+export interface RecoveryOptions {
+    readonly targetTime?: Date;
+    readonly targetLsn?: string;
+    readonly targetTransactionId?: string;
+    readonly targetName?: string;
+    readonly inclusive?: boolean;
+    readonly targetDatabase?: string;
+    readonly restartAfterRecovery?: boolean;
+    readonly standbyMode?: boolean;
+}
+/** Recovery progress */
+export interface RecoveryProgress {
+    readonly phase: 'preparing' | 'restoring' | 'replaying' | 'verifying' | 'complete' | 'failed';
+    readonly backupRestorePercent?: number;
+    readonly walReplayPercent?: number;
+    readonly currentLsn?: string;
+    readonly targetLsn?: string;
+    readonly estimatedTimeRemaining?: number;
+    readonly filesProcessed?: number;
+    readonly totalFiles?: number;
+    readonly bytesProcessed?: number;
+    readonly totalBytes?: number;
+    readonly errors: readonly string[];
+}
+/** Database user */
+export interface DbUser {
+    readonly name: string;
+    readonly roles: readonly string[];
+    readonly defaultRole?: string;
+    readonly canLogin: boolean;
+    readonly isSuperuser: boolean;
+    readonly createDb: boolean;
+    readonly createRole: boolean;
+    readonly replication: boolean;
+    readonly bypassRls: boolean;
+    readonly connectionLimit: number;
+    readonly passwordExpiry?: Date;
+    readonly validUntil?: Date;
+    readonly config?: Record<string, string>;
+    readonly createdAt?: Date;
+    readonly lastLogin?: Date;
+}
+/** Database role */
+export interface DbRole {
+    readonly name: string;
+    readonly inherits: boolean;
+    readonly members: readonly string[];
+    readonly memberOf: readonly string[];
+    readonly isSystem: boolean;
+    readonly createdAt?: Date;
+    readonly comment?: string;
+}
+/** User creation options */
+export interface CreateUserOptions {
+    readonly name: string;
+    readonly password?: string;
+    readonly roles?: readonly string[];
+    readonly canLogin?: boolean;
+    readonly isSuperuser?: boolean;
+    readonly createDb?: boolean;
+    readonly createRole?: boolean;
+    readonly replication?: boolean;
+    readonly connectionLimit?: number;
+    readonly validUntil?: Date;
+    readonly config?: Record<string, string>;
+}
+/** Permission entry */
+export interface PermissionEntry {
+    readonly grantee: string;
+    readonly granteeType: 'user' | 'role' | 'group' | 'public';
+    readonly objectType: PermissionObjectType;
+    readonly objectName: string;
+    readonly schema?: string;
+    readonly privileges: readonly Privilege[];
+    readonly withGrantOption: boolean;
+    readonly grantor: string;
+}
+/** Permission object type */
+export type PermissionObjectType = 'database' | 'schema' | 'table' | 'view' | 'column' | 'sequence' | 'function' | 'procedure' | 'type' | 'domain' | 'tablespace';
+/** Privilege type */
+export type Privilege = 'SELECT' | 'INSERT' | 'UPDATE' | 'DELETE' | 'TRUNCATE' | 'REFERENCES' | 'TRIGGER' | 'CREATE' | 'CONNECT' | 'TEMPORARY' | 'EXECUTE' | 'USAGE' | 'ALTER' | 'DROP' | 'ALL';
+/** Permission matrix row */
+export interface PermissionMatrixRow {
+    readonly objectName: string;
+    readonly objectType: PermissionObjectType;
+    readonly schema?: string;
+    readonly permissions: Record<string, readonly Privilege[]>;
+}
+/** Audit log entry */
+export interface AuditLogEntry {
+    readonly id: string;
+    readonly timestamp: Date;
+    readonly username: string;
+    readonly database: string;
+    readonly clientAddress?: string;
+    readonly applicationName?: string;
+    readonly sessionId?: string;
+    readonly transactionId?: string;
+    readonly objectType?: string;
+    readonly objectName?: string;
+    readonly commandTag: string;
+    readonly statement?: string;
+    readonly parameters?: readonly unknown[];
+    readonly result: 'success' | 'error';
+    readonly errorMessage?: string;
+    readonly rowsAffected?: number;
+    readonly duration?: number;
+}
+/** Audit log filter */
+export interface AuditLogFilter {
+    readonly startTime?: Date;
+    readonly endTime?: Date;
+    readonly usernames?: readonly string[];
+    readonly databases?: readonly string[];
+    readonly commandTags?: readonly string[];
+    readonly objectTypes?: readonly string[];
+    readonly objectNames?: readonly string[];
+    readonly resultFilter?: 'success' | 'error' | 'all';
+    readonly searchText?: string;
+    readonly limit?: number;
+    readonly offset?: number;
+}
+/** Audit summary */
+export interface AuditSummary {
+    readonly period: {
+        start: Date;
+        end: Date;
+    };
+    readonly totalEvents: number;
+    readonly successCount: number;
+    readonly errorCount: number;
+    readonly uniqueUsers: number;
+    readonly topUsers: readonly {
+        user: string;
+        count: number;
+    }[];
+    readonly topCommands: readonly {
+        command: string;
+        count: number;
+    }[];
+    readonly topTables: readonly {
+        table: string;
+        accesses: number;
+    }[];
+    readonly errorsByType: readonly {
+        error: string;
+        count: number;
+    }[];
+}
+/** Performance metrics */
+export interface PerformanceMetrics {
+    readonly timestamp: Date;
+    readonly cpu: CpuMetrics;
+    readonly memory: MemoryMetrics;
+    readonly disk: DiskMetrics;
+    readonly network: NetworkMetrics;
+    readonly database: DatabaseMetrics;
+    readonly queries: QueryMetrics;
+}
+/** CPU metrics */
+export interface CpuMetrics {
+    readonly userPercent: number;
+    readonly systemPercent: number;
+    readonly idlePercent: number;
+    readonly iowaitPercent: number;
+    readonly loadAverage: {
+        one: number;
+        five: number;
+        fifteen: number;
+    };
+}
+/** Memory metrics */
+export interface MemoryMetrics {
+    readonly totalBytes: number;
+    readonly usedBytes: number;
+    readonly freeBytes: number;
+    readonly cachedBytes: number;
+    readonly bufferedBytes: number;
+    readonly swapUsedBytes: number;
+    readonly swapFreeBytes: number;
+}
+/** Disk metrics */
+export interface DiskMetrics {
+    readonly readBytesPerSec: number;
+    readonly writeBytesPerSec: number;
+    readonly readOpsPerSec: number;
+    readonly writeOpsPerSec: number;
+    readonly avgReadLatency: number;
+    readonly avgWriteLatency: number;
+    readonly queueLength: number;
+    readonly utilizationPercent: number;
+}
+/** Network metrics */
+export interface NetworkMetrics {
+    readonly rxBytesPerSec: number;
+    readonly txBytesPerSec: number;
+    readonly rxPacketsPerSec: number;
+    readonly txPacketsPerSec: number;
+    readonly rxErrors: number;
+    readonly txErrors: number;
+    readonly connections: number;
+}
+/** Database-specific metrics */
+export interface DatabaseMetrics {
+    readonly connections: number;
+    readonly maxConnections: number;
+    readonly activeQueries: number;
+    readonly transactionsPerSec: number;
+    readonly commitsPerSec: number;
+    readonly rollbacksPerSec: number;
+    readonly blocksRead: number;
+    readonly blocksHit: number;
+    readonly cacheHitRatio: number;
+    readonly tuplesReturned: number;
+    readonly tuplesInserted: number;
+    readonly tuplesUpdated: number;
+    readonly tuplesDeleted: number;
+    readonly deadlocks: number;
+    readonly conflicts: number;
+    readonly tempFiles: number;
+    readonly tempBytes: number;
+}
+/** Query metrics */
+export interface QueryMetrics {
+    readonly queriesPerSec: number;
+    readonly avgQueryTime: number;
+    readonly slowQueries: number;
+    readonly failedQueries: number;
+    readonly waitingQueries: number;
+}
+/** Database space info */
+export interface DatabaseSpaceInfo {
+    readonly name: string;
+    readonly size: number;
+    readonly dataSize: number;
+    readonly indexSize: number;
+    readonly freeSpace?: number;
+    readonly tableCount: number;
+    readonly growth: SpaceGrowth;
+}
+/** Table space info */
+export interface TableSpaceInfo {
+    readonly name: string;
+    readonly schema: string;
+    readonly rowCount: number;
+    readonly totalSize: number;
+    readonly tableSize: number;
+    readonly indexSize: number;
+    readonly toastSize?: number;
+    readonly bloatPercent?: number;
+    readonly bloatBytes?: number;
+    readonly lastVacuum?: Date;
+    readonly lastAnalyze?: Date;
+    readonly lastAutoVacuum?: Date;
+    readonly deadTuples?: number;
+    readonly liveTuples?: number;
+}
+/** Space growth */
+export interface SpaceGrowth {
+    readonly daily: number;
+    readonly weekly: number;
+    readonly monthly: number;
+    readonly trend: 'increasing' | 'stable' | 'decreasing';
+    readonly projectedSize30Days?: number;
+    readonly projectedSize90Days?: number;
+}
+/** Bloat analysis */
+export interface BloatAnalysis {
+    readonly tableName: string;
+    readonly schema: string;
+    readonly actualSize: number;
+    readonly expectedSize: number;
+    readonly bloatSize: number;
+    readonly bloatPercent: number;
+    readonly wastedBytes: number;
+    readonly recommendation: 'none' | 'vacuum' | 'vacuum_full' | 'reindex';
+    readonly vacuumCommand: string;
+}
+//# sourceMappingURL=db-admin.d.ts.map