anantham-v2 2.0.0-alpha.1 → 2.0.2

package/dist/persistence/database-backup-manager.d.ts

@@ -0,0 +1,342 @@
+import { z } from "zod";
+import { SqliteEngine } from "./sqlite-engine.js";
+export declare const BackupScopeSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    includeArtifacts: z.ZodDefault<z.ZodBoolean>;
+    includeAttachments: z.ZodDefault<z.ZodBoolean>;
+    includeWorkflows: z.ZodDefault<z.ZodBoolean>;
+    includeConfig: z.ZodDefault<z.ZodBoolean>;
+    includePluginMetadata: z.ZodDefault<z.ZodBoolean>;
+    includeSkillMetadata: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeArtifacts: boolean;
+    includeAttachments: boolean;
+    includeWorkflows: boolean;
+    includeConfig: boolean;
+    includePluginMetadata: boolean;
+    includeSkillMetadata: boolean;
+    projectId?: string | undefined;
+}, {
+    projectId?: string | undefined;
+    includeArtifacts?: boolean | undefined;
+    includeAttachments?: boolean | undefined;
+    includeWorkflows?: boolean | undefined;
+    includeConfig?: boolean | undefined;
+    includePluginMetadata?: boolean | undefined;
+    includeSkillMetadata?: boolean | undefined;
+}>;
+export type BackupScope = z.infer<typeof BackupScopeSchema>;
+export declare const BackupEncryptionMetadataSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    algorithm: z.ZodOptional<z.ZodEnum<["AES-256-GCM"]>>;
+    keyDerivation: z.ZodOptional<z.ZodEnum<["PBKDF2", "RAW"]>>;
+    saltHex: z.ZodOptional<z.ZodString>;
+    ivHex: z.ZodOptional<z.ZodString>;
+    tagHex: z.ZodOptional<z.ZodString>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    algorithm?: "AES-256-GCM" | undefined;
+    keyDerivation?: "PBKDF2" | "RAW" | undefined;
+    saltHex?: string | undefined;
+    ivHex?: string | undefined;
+    tagHex?: string | undefined;
+    iterations?: number | undefined;
+}, {
+    enabled: boolean;
+    algorithm?: "AES-256-GCM" | undefined;
+    keyDerivation?: "PBKDF2" | "RAW" | undefined;
+    saltHex?: string | undefined;
+    ivHex?: string | undefined;
+    tagHex?: string | undefined;
+    iterations?: number | undefined;
+}>;
+export type BackupEncryptionMetadata = z.infer<typeof BackupEncryptionMetadataSchema>;
+export declare const BackupEntityCountsSchema: z.ZodObject<{
+    projects: z.ZodNumber;
+    sessions: z.ZodNumber;
+    events: z.ZodNumber;
+    tasks: z.ZodNumber;
+    checkpoints: z.ZodNumber;
+    memoryItems: z.ZodNumber;
+    artifacts: z.ZodNumber;
+    attachments: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    tasks: number;
+    artifacts: number;
+    events: number;
+    projects: number;
+    sessions: number;
+    checkpoints: number;
+    memoryItems: number;
+    attachments: number;
+}, {
+    tasks: number;
+    artifacts: number;
+    events: number;
+    projects: number;
+    sessions: number;
+    checkpoints: number;
+    memoryItems: number;
+    attachments: number;
+}>;
+export type BackupEntityCounts = z.infer<typeof BackupEntityCountsSchema>;
+export declare const BackupManifestSchema: z.ZodObject<{
+    backupId: z.ZodString;
+    version: z.ZodLiteral<1>;
+    createdAt: z.ZodString;
+    generator: z.ZodString;
+    schemaVersion: z.ZodNumber;
+    scope: z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        includeArtifacts: z.ZodDefault<z.ZodBoolean>;
+        includeAttachments: z.ZodDefault<z.ZodBoolean>;
+        includeWorkflows: z.ZodDefault<z.ZodBoolean>;
+        includeConfig: z.ZodDefault<z.ZodBoolean>;
+        includePluginMetadata: z.ZodDefault<z.ZodBoolean>;
+        includeSkillMetadata: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        includeArtifacts: boolean;
+        includeAttachments: boolean;
+        includeWorkflows: boolean;
+        includeConfig: boolean;
+        includePluginMetadata: boolean;
+        includeSkillMetadata: boolean;
+        projectId?: string | undefined;
+    }, {
+        projectId?: string | undefined;
+        includeArtifacts?: boolean | undefined;
+        includeAttachments?: boolean | undefined;
+        includeWorkflows?: boolean | undefined;
+        includeConfig?: boolean | undefined;
+        includePluginMetadata?: boolean | undefined;
+        includeSkillMetadata?: boolean | undefined;
+    }>;
+    counts: z.ZodObject<{
+        projects: z.ZodNumber;
+        sessions: z.ZodNumber;
+        events: z.ZodNumber;
+        tasks: z.ZodNumber;
+        checkpoints: z.ZodNumber;
+        memoryItems: z.ZodNumber;
+        artifacts: z.ZodNumber;
+        attachments: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        tasks: number;
+        artifacts: number;
+        events: number;
+        projects: number;
+        sessions: number;
+        checkpoints: number;
+        memoryItems: number;
+        attachments: number;
+    }, {
+        tasks: number;
+        artifacts: number;
+        events: number;
+        projects: number;
+        sessions: number;
+        checkpoints: number;
+        memoryItems: number;
+        attachments: number;
+    }>;
+    checksums: z.ZodObject<{
+        dbSha256: z.ZodString;
+        manifestSha256: z.ZodString;
+        artifactChecksums: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dbSha256: string;
+        manifestSha256: string;
+        artifactChecksums?: Record<string, string> | undefined;
+    }, {
+        dbSha256: string;
+        manifestSha256: string;
+        artifactChecksums?: Record<string, string> | undefined;
+    }>;
+    encryption: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        algorithm: z.ZodOptional<z.ZodEnum<["AES-256-GCM"]>>;
+        keyDerivation: z.ZodOptional<z.ZodEnum<["PBKDF2", "RAW"]>>;
+        saltHex: z.ZodOptional<z.ZodString>;
+        ivHex: z.ZodOptional<z.ZodString>;
+        tagHex: z.ZodOptional<z.ZodString>;
+        iterations: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        algorithm?: "AES-256-GCM" | undefined;
+        keyDerivation?: "PBKDF2" | "RAW" | undefined;
+        saltHex?: string | undefined;
+        ivHex?: string | undefined;
+        tagHex?: string | undefined;
+        iterations?: number | undefined;
+    }, {
+        enabled: boolean;
+        algorithm?: "AES-256-GCM" | undefined;
+        keyDerivation?: "PBKDF2" | "RAW" | undefined;
+        saltHex?: string | undefined;
+        ivHex?: string | undefined;
+        tagHex?: string | undefined;
+        iterations?: number | undefined;
+    }>;
+    credentialsExcluded: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    createdAt: string;
+    scope: {
+        includeArtifacts: boolean;
+        includeAttachments: boolean;
+        includeWorkflows: boolean;
+        includeConfig: boolean;
+        includePluginMetadata: boolean;
+        includeSkillMetadata: boolean;
+        projectId?: string | undefined;
+    };
+    schemaVersion: number;
+    backupId: string;
+    generator: string;
+    counts: {
+        tasks: number;
+        artifacts: number;
+        events: number;
+        projects: number;
+        sessions: number;
+        checkpoints: number;
+        memoryItems: number;
+        attachments: number;
+    };
+    checksums: {
+        dbSha256: string;
+        manifestSha256: string;
+        artifactChecksums?: Record<string, string> | undefined;
+    };
+    encryption: {
+        enabled: boolean;
+        algorithm?: "AES-256-GCM" | undefined;
+        keyDerivation?: "PBKDF2" | "RAW" | undefined;
+        saltHex?: string | undefined;
+        ivHex?: string | undefined;
+        tagHex?: string | undefined;
+        iterations?: number | undefined;
+    };
+    credentialsExcluded: true;
+}, {
+    version: 1;
+    createdAt: string;
+    scope: {
+        projectId?: string | undefined;
+        includeArtifacts?: boolean | undefined;
+        includeAttachments?: boolean | undefined;
+        includeWorkflows?: boolean | undefined;
+        includeConfig?: boolean | undefined;
+        includePluginMetadata?: boolean | undefined;
+        includeSkillMetadata?: boolean | undefined;
+    };
+    schemaVersion: number;
+    backupId: string;
+    generator: string;
+    counts: {
+        tasks: number;
+        artifacts: number;
+        events: number;
+        projects: number;
+        sessions: number;
+        checkpoints: number;
+        memoryItems: number;
+        attachments: number;
+    };
+    checksums: {
+        dbSha256: string;
+        manifestSha256: string;
+        artifactChecksums?: Record<string, string> | undefined;
+    };
+    encryption: {
+        enabled: boolean;
+        algorithm?: "AES-256-GCM" | undefined;
+        keyDerivation?: "PBKDF2" | "RAW" | undefined;
+        saltHex?: string | undefined;
+        ivHex?: string | undefined;
+        tagHex?: string | undefined;
+        iterations?: number | undefined;
+    };
+    credentialsExcluded: true;
+}>;
+export type BackupManifest = z.infer<typeof BackupManifestSchema>;
+export interface CreateBackupOptions {
+    destinationPath?: string;
+    scope?: Partial<BackupScope>;
+    passphrase?: string;
+    keyBuffer?: Buffer;
+    label?: string;
+}
+export interface RestoreDryRunReport {
+    backupId: string;
+    createdAt: string;
+    schemaVersion: number;
+    isCompatible: boolean;
+    counts: BackupEntityCounts;
+    conflicts: {
+        existingProjectsCount: number;
+        existingSessionsCount: number;
+        existingTasksCount: number;
+        conflictingProjectIds: string[];
+        conflictingSessionIds: string[];
+    };
+    integrityCheckPassed: boolean;
+    foreignKeyCheckPassed: boolean;
+    warnings: string[];
+    errors: string[];
+}
+export interface RestoreOptions {
+    passphrase?: string;
+    keyBuffer?: Buffer;
+    force?: boolean;
+    targetDbPath?: string;
+    targetArtifactsDir?: string;
+}
+export interface RestoreResult {
+    success: boolean;
+    backupId: string;
+    restoredAt: string;
+    restoredCounts: BackupEntityCounts;
+    durationMs: number;
+    report: RestoreDryRunReport;
+}
+export interface DatabaseBackupManagerOptions {
+    engine: SqliteEngine;
+    artifactsDir?: string;
+    attachmentsDir?: string;
+    backupStorageDir?: string;
+}
+export declare class DatabaseBackupManager {
+    private readonly engine;
+    private readonly backupStorageDir;
+    constructor(options: DatabaseBackupManagerOptions);
+    private countTable;
+    getEntityCounts(): BackupEntityCounts;
+    private deriveKey;
+    createBackup(options?: CreateBackupOptions): Promise<{
+        backupPath: string;
+        manifest: BackupManifest;
+    }>;
+    inspectBackup(backupPath: string, _options?: {
+        passphrase?: string;
+        keyBuffer?: Buffer;
+    }): Promise<BackupManifest>;
+    dryRunRestore(backupPath: string, options?: {
+        passphrase?: string;
+        keyBuffer?: Buffer;
+    }): Promise<RestoreDryRunReport>;
+    private extractDbToPath;
+    restoreBackup(backupPath: string, options?: RestoreOptions): Promise<RestoreResult>;
+    pointInTimeRestore(backupPath: string, pointInTime: {
+        timestamp?: string;
+        eventId?: string;
+        sequenceOffset?: number;
+    }, options?: RestoreOptions): Promise<RestoreResult>;
+    listBackups(): Promise<Array<{
+        backupPath: string;
+        manifest: BackupManifest;
+        sizeBytes: number;
+    }>>;
+}
+//# sourceMappingURL=database-backup-manager.d.ts.map

package/dist/persistence/database-backup-manager.d.ts.map

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