@nahisaho/musubix-core 1.0.0

package/dist/error/data-persistence.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Data Persistence
+ *
+ * Ensures data durability and recovery capabilities
+ *
+ * @packageDocumentation
+ * @module error/data-persistence
+ *
+ * @see REQ-ERR-002 - Data Persistence
+ * @see Article V - Safety Assurance
+ */
+/**
+ * Storage backend type
+ */
+export type StorageBackend = 'memory' | 'file' | 'custom';
+/**
+ * Data state
+ */
+export type DataState = 'pending' | 'persisted' | 'corrupted' | 'recovered';
+/**
+ * Checkpoint
+ */
+export interface Checkpoint {
+    /** Checkpoint ID */
+    id: string;
+    /** Timestamp */
+    timestamp: Date;
+    /** Data snapshot */
+    data: unknown;
+    /** Checksum */
+    checksum: string;
+    /** Version */
+    version: number;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Transaction
+ */
+export interface Transaction {
+    /** Transaction ID */
+    id: string;
+    /** Started at */
+    startedAt: Date;
+    /** Completed at */
+    completedAt?: Date;
+    /** Operations */
+    operations: TransactionOperation[];
+    /** Status */
+    status: 'pending' | 'committed' | 'rolled-back' | 'failed';
+    /** Checkpoint before transaction */
+    beforeCheckpoint?: string;
+}
+/**
+ * Transaction operation
+ */
+export interface TransactionOperation {
+    /** Operation type */
+    type: 'set' | 'delete' | 'update';
+    /** Key */
+    key: string;
+    /** Value (for set/update) */
+    value?: unknown;
+    /** Previous value (for rollback) */
+    previousValue?: unknown;
+    /** Timestamp */
+    timestamp: Date;
+}
+/**
+ * Recovery result
+ */
+export interface RecoveryResult {
+    /** Success */
+    success: boolean;
+    /** Recovered checkpoint */
+    checkpoint?: Checkpoint;
+    /** Data recovered */
+    dataRecovered: boolean;
+    /** Items recovered */
+    itemsRecovered: number;
+    /** Errors */
+    errors: string[];
+    /** Warnings */
+    warnings: string[];
+}
+/**
+ * Persistence statistics
+ */
+export interface PersistenceStatistics {
+    /** Total items */
+    totalItems: number;
+    /** Total checkpoints */
+    totalCheckpoints: number;
+    /** Pending transactions */
+    pendingTransactions: number;
+    /** Last checkpoint */
+    lastCheckpoint?: Date;
+    /** Storage size (bytes) */
+    storageSize: number;
+    /** Corrupted items */
+    corruptedItems: number;
+}
+/**
+ * Data persistence config
+ */
+export interface DataPersistenceConfig {
+    /** Storage backend */
+    backend: StorageBackend;
+    /** Storage path (for file backend) */
+    storagePath?: string;
+    /** Auto-checkpoint interval (ms) */
+    autoCheckpointInterval?: number;
+    /** Max checkpoints to keep */
+    maxCheckpoints: number;
+    /** Enable transactions */
+    enableTransactions: boolean;
+    /** Enable integrity checks */
+    enableIntegrityChecks: boolean;
+    /** Custom storage adapter */
+    customAdapter?: StorageAdapter;
+}
+/**
+ * Storage adapter interface
+ */
+export interface StorageAdapter {
+    get(key: string): Promise<unknown | null>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+/**
+ * In-memory storage adapter
+ */
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private data;
+    get(key: string): Promise<unknown | null>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+/**
+ * File storage adapter
+ */
+export declare class FileStorageAdapter implements StorageAdapter {
+    private basePath;
+    constructor(basePath: string);
+    private getFilePath;
+    get(key: string): Promise<unknown | null>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_PERSISTENCE_CONFIG: DataPersistenceConfig;
+/**
+ * Data Persistence Manager
+ */
+export declare class DataPersistence {
+    private config;
+    private adapter;
+    private checkpoints;
+    private transactions;
+    private currentTransaction;
+    private version;
+    private checkpointCounter;
+    private transactionCounter;
+    private checkpointTimer?;
+    constructor(config?: Partial<DataPersistenceConfig>);
+    /**
+     * Create storage adapter based on config
+     */
+    private createAdapter;
+    /**
+     * Start auto-checkpoint timer
+     */
+    private startAutoCheckpoint;
+    /**
+     * Stop auto-checkpoint timer
+     */
+    stop(): void;
+    /**
+     * Set a value
+     */
+    set(key: string, value: unknown): Promise<void>;
+    /**
+     * Get a value
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Delete a value
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List all keys
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Clear all data
+     */
+    clear(): Promise<void>;
+    /**
+     * Begin a transaction
+     */
+    beginTransaction(): string;
+    /**
+     * Commit the current transaction
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback the current transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Create a checkpoint
+     */
+    createCheckpoint(metadata?: Record<string, unknown>): Promise<Checkpoint>;
+    /**
+     * Restore from checkpoint
+     */
+    restoreCheckpoint(checkpointId: string): Promise<RecoveryResult>;
+    /**
+     * Restore from latest checkpoint
+     */
+    restoreLatest(): Promise<RecoveryResult>;
+    /**
+     * Get all checkpoints
+     */
+    getCheckpoints(): Checkpoint[];
+    /**
+     * Get latest checkpoint
+     */
+    getLatestCheckpoint(): Checkpoint | null;
+    /**
+     * Verify data integrity
+     */
+    verifyIntegrity(): Promise<{
+        valid: boolean;
+        errors: string[];
+        corruptedKeys: string[];
+    }>;
+    /**
+     * Repair corrupted data
+     */
+    repair(): Promise<RecoveryResult>;
+    /**
+     * Get statistics
+     */
+    getStatistics(): Promise<PersistenceStatistics>;
+    /**
+     * Export all data
+     */
+    export(): Promise<{
+        data: Record<string, unknown>;
+        checkpoints: Checkpoint[];
+        version: number;
+        exportedAt: Date;
+    }>;
+    /**
+     * Import data
+     */
+    import(exportData: {
+        data: Record<string, unknown>;
+        checkpoints?: Checkpoint[];
+        version?: number;
+    }): Promise<void>;
+    /**
+     * Calculate checksum
+     */
+    private calculateChecksum;
+}
+/**
+ * Create data persistence instance
+ */
+export declare function createDataPersistence(config?: Partial<DataPersistenceConfig>): DataPersistence;
+/**
+ * Write-ahead log
+ */
+export declare class WriteAheadLog {
+    private log;
+    private committed;
+    /**
+     * Append operation to log
+     */
+    append(operation: TransactionOperation): void;
+    /**
+     * Mark operations as committed
+     */
+    commit(transactionId: string): void;
+    /**
+     * Get uncommitted operations
+     */
+    getUncommitted(): TransactionOperation[];
+    /**
+     * Clear committed operations
+     */
+    cleanup(): void;
+    /**
+     * Get all operations
+     */
+    getAll(): TransactionOperation[];
+    /**
+     * Clear log
+     */
+    clear(): void;
+}
+//# sourceMappingURL=data-persistence.d.ts.map

package/dist/error/data-persistence.d.ts.map

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