dbdock 1.1.0

package/dist/storage/adapters/s3.adapter.js

@@ -0,0 +1,199 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var S3StorageAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3StorageAdapter = void 0;
+const common_1 = require("@nestjs/common");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const lib_storage_1 = require("@aws-sdk/lib-storage");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+let S3StorageAdapter = S3StorageAdapter_1 = class S3StorageAdapter {
+    logger = new common_1.Logger(S3StorageAdapter_1.name);
+    client;
+    bucket;
+    constructor(config) {
+        this.bucket = config.bucket;
+        this.client = new client_s3_1.S3Client({
+            endpoint: config.endpoint,
+            region: config.region || 'us-east-1',
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+            forcePathStyle: config.forcePathStyle ?? false,
+        });
+        this.logger.log(`S3 adapter initialized for bucket: ${this.bucket}`);
+    }
+    async uploadStream(stream, options) {
+        try {
+            const upload = new lib_storage_1.Upload({
+                client: this.client,
+                params: {
+                    Bucket: this.bucket,
+                    Key: options.key,
+                    Body: stream,
+                    ContentType: options.contentType,
+                    Metadata: options.metadata,
+                },
+            });
+            upload.on('httpUploadProgress', (progress) => {
+                if (progress.loaded && progress.total) {
+                    const percent = ((progress.loaded / progress.total) * 100).toFixed(2);
+                    this.logger.log(`Upload progress for ${options.key}: ${percent}%`);
+                }
+            });
+            const result = await upload.done();
+            this.logger.log(`Uploaded ${options.key} to S3`);
+            return {
+                key: options.key,
+                etag: result.ETag,
+            };
+        }
+        catch (error) {
+            const friendlyMessage = this.getFriendlyError(error);
+            this.logger.error(`Failed to upload ${options.key}: ${friendlyMessage}`);
+            const cleanError = new Error(friendlyMessage);
+            cleanError.name = 'StorageConfigurationError';
+            throw cleanError;
+        }
+    }
+    async downloadStream(options) {
+        try {
+            const command = new client_s3_1.GetObjectCommand({
+                Bucket: this.bucket,
+                Key: options.key,
+            });
+            const response = await this.client.send(command);
+            if (!response.Body) {
+                throw new Error(`No body in response for ${options.key}`);
+            }
+            return response.Body;
+        }
+        catch (error) {
+            const friendlyMessage = this.getFriendlyError(error);
+            this.logger.error(`Failed to download ${options.key}: ${friendlyMessage}`);
+            const cleanError = new Error(friendlyMessage);
+            cleanError.name = 'StorageConfigurationError';
+            throw cleanError;
+        }
+    }
+    async listObjects(options) {
+        try {
+            const command = new client_s3_1.ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: options?.prefix,
+                MaxKeys: options?.maxKeys || 1000,
+                StartAfter: options?.startAfter,
+            });
+            const response = await this.client.send(command);
+            if (!response.Contents) {
+                return [];
+            }
+            return response.Contents.map((obj) => ({
+                key: obj.Key,
+                size: obj.Size || 0,
+                lastModified: obj.LastModified || new Date(),
+            }));
+        }
+        catch (error) {
+            const friendlyMessage = this.getFriendlyError(error);
+            this.logger.error(`Failed to list objects: ${friendlyMessage}`);
+            const cleanError = new Error(friendlyMessage);
+            cleanError.name = 'StorageConfigurationError';
+            throw cleanError;
+        }
+    }
+    async deleteObject(options) {
+        try {
+            const command = new client_s3_1.DeleteObjectCommand({
+                Bucket: this.bucket,
+                Key: options.key,
+            });
+            await this.client.send(command);
+            this.logger.log(`Deleted ${options.key} from S3`);
+        }
+        catch (error) {
+            const friendlyMessage = this.getFriendlyError(error);
+            this.logger.error(`Failed to delete ${options.key}: ${friendlyMessage}`);
+            const cleanError = new Error(friendlyMessage);
+            cleanError.name = 'StorageConfigurationError';
+            throw cleanError;
+        }
+    }
+    async generatePresignedUrl(options) {
+        try {
+            const command = new client_s3_1.GetObjectCommand({
+                Bucket: this.bucket,
+                Key: options.key,
+            });
+            const url = await (0, s3_request_presigner_1.getSignedUrl)(this.client, command, {
+                expiresIn: options.expiresIn || 3600,
+            });
+            return url;
+        }
+        catch (error) {
+            const friendlyMessage = this.getFriendlyError(error);
+            this.logger.error(`Failed to generate presigned URL for ${options.key}: ${friendlyMessage}`);
+            const cleanError = new Error(friendlyMessage);
+            cleanError.name = 'StorageConfigurationError';
+            throw cleanError;
+        }
+    }
+    async objectExists(key) {
+        try {
+            const command = new client_s3_1.HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            });
+            await this.client.send(command);
+            return true;
+        }
+        catch (error) {
+            if (error.name === 'NotFound') {
+                return false;
+            }
+            throw error;
+        }
+    }
+    getFriendlyError(error) {
+        const err = error;
+        const code = err?.code;
+        const message = err?.message || '';
+        if (code === 'EPROTO' || message.includes('SSL') || message.includes('TLS')) {
+            return 'Invalid storage configuration: SSL/TLS handshake failed. Please verify your endpoint URL, access key ID, and secret access key are correct.';
+        }
+        if (code === 'ENOTFOUND' || message.includes('getaddrinfo')) {
+            return 'Invalid storage configuration: Could not resolve endpoint hostname. Please verify your endpoint URL is correct.';
+        }
+        if (code === 'SignatureDoesNotMatch' || message.includes('signature')) {
+            return 'Invalid storage configuration: Authentication failed. Please verify your access key ID and secret access key are correct.';
+        }
+        if (code === 'InvalidAccessKeyId') {
+            return 'Invalid storage configuration: Access key ID not found. Please verify your access key ID is correct.';
+        }
+        if (code === 'NoSuchBucket') {
+            return `Invalid storage configuration: Bucket "${this.bucket}" does not exist. Please verify your bucket name is correct.`;
+        }
+        if (code === 'AccessDenied' || code === 'Forbidden') {
+            return 'Invalid storage configuration: Access denied. Please verify your credentials have the necessary permissions for this bucket.';
+        }
+        if (code === 'ETIMEDOUT' || code === 'ECONNREFUSED') {
+            return 'Invalid storage configuration: Connection failed. Please verify your endpoint URL and network connectivity.';
+        }
+        return message || 'Unknown storage error occurred';
+    }
+};
+exports.S3StorageAdapter = S3StorageAdapter;
+exports.S3StorageAdapter = S3StorageAdapter = S3StorageAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], S3StorageAdapter);
+//# sourceMappingURL=s3.adapter.js.map

package/dist/storage/adapters/s3.adapter.js.map

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

package/dist/storage/storage.interface.d.ts

@@ -0,0 +1,38 @@
+import { Readable } from 'stream';
+export interface UploadOptions {
+    key: string;
+    metadata?: Record<string, string>;
+    contentType?: string;
+}
+export interface DownloadOptions {
+    key: string;
+}
+export interface ListOptions {
+    prefix?: string;
+    maxKeys?: number;
+    startAfter?: string;
+}
+export interface StorageObject {
+    key: string;
+    size: number;
+    lastModified: Date;
+    metadata?: Record<string, string>;
+}
+export interface DeleteOptions {
+    key: string;
+}
+export interface PresignedUrlOptions {
+    key: string;
+    expiresIn?: number;
+}
+export interface IStorageAdapter {
+    uploadStream(stream: Readable, options: UploadOptions): Promise<{
+        key: string;
+        etag?: string;
+    }>;
+    downloadStream(options: DownloadOptions): Promise<Readable>;
+    listObjects(options?: ListOptions): Promise<StorageObject[]>;
+    deleteObject(options: DeleteOptions): Promise<void>;
+    generatePresignedUrl(options: PresignedUrlOptions): Promise<string>;
+    objectExists(key: string): Promise<boolean>;
+}

package/dist/storage/storage.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=storage.interface.js.map

package/dist/storage/storage.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.interface.js","sourceRoot":"","sources":["../../src/storage/storage.interface.ts"],"names":[],"mappings":""}

package/dist/storage/storage.module.d.ts

@@ -0,0 +1,2 @@
+export declare class StorageModule {
+}

package/dist/storage/storage.module.js

@@ -0,0 +1,21 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageModule = void 0;
+const common_1 = require("@nestjs/common");
+const storage_service_1 = require("./storage.service");
+let StorageModule = class StorageModule {
+};
+exports.StorageModule = StorageModule;
+exports.StorageModule = StorageModule = __decorate([
+    (0, common_1.Module)({
+        providers: [storage_service_1.StorageService],
+        exports: [storage_service_1.StorageService],
+    })
+], StorageModule);
+//# sourceMappingURL=storage.module.js.map

package/dist/storage/storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.js","sourceRoot":"","sources":["../../src/storage/storage.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,uDAAmD;AAM5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAJzB,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,gCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

package/dist/storage/storage.service.d.ts

@@ -0,0 +1,10 @@
+import { DBDockConfigService } from '../config/config.service';
+import { IStorageAdapter } from './storage.interface';
+export declare class StorageService {
+    private configService;
+    private readonly logger;
+    private adapter;
+    constructor(configService: DBDockConfigService);
+    private initializeAdapter;
+    getAdapter(): IStorageAdapter;
+}

package/dist/storage/storage.service.js

@@ -0,0 +1,89 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var StorageService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../config/config.service");
+const local_adapter_1 = require("./adapters/local.adapter");
+const s3_adapter_1 = require("./adapters/s3.adapter");
+const r2_adapter_1 = require("./adapters/r2.adapter");
+const cloudinary_adapter_1 = require("./adapters/cloudinary.adapter");
+const config_schema_1 = require("../config/config.schema");
+let StorageService = StorageService_1 = class StorageService {
+    configService;
+    logger = new common_1.Logger(StorageService_1.name);
+    adapter;
+    constructor(configService) {
+        this.configService = configService;
+        this.initializeAdapter();
+    }
+    initializeAdapter() {
+        const storageConfig = this.configService.get('storage');
+        switch (storageConfig.provider) {
+            case config_schema_1.StorageProvider.LOCAL:
+                this.adapter = new local_adapter_1.LocalStorageAdapter(storageConfig.localPath || './backups');
+                this.logger.log('Initialized local storage adapter');
+                break;
+            case config_schema_1.StorageProvider.S3:
+                if (!storageConfig.accessKeyId || !storageConfig.secretAccessKey) {
+                    throw new Error('S3 credentials are required');
+                }
+                this.adapter = new s3_adapter_1.S3StorageAdapter({
+                    endpoint: storageConfig.endpoint,
+                    bucket: storageConfig.bucket,
+                    accessKeyId: storageConfig.accessKeyId,
+                    secretAccessKey: storageConfig.secretAccessKey,
+                });
+                this.logger.log('Initialized S3 storage adapter');
+                break;
+            case config_schema_1.StorageProvider.R2:
+                if (!storageConfig.accessKeyId || !storageConfig.secretAccessKey) {
+                    throw new Error('R2 credentials are required');
+                }
+                if (!storageConfig.endpoint) {
+                    throw new Error('R2 account ID is required in endpoint');
+                }
+                const accountId = storageConfig.endpoint.split('.')[0];
+                this.adapter = new r2_adapter_1.R2StorageAdapter({
+                    accountId,
+                    bucket: storageConfig.bucket,
+                    accessKeyId: storageConfig.accessKeyId,
+                    secretAccessKey: storageConfig.secretAccessKey,
+                });
+                this.logger.log('Initialized R2 storage adapter');
+                break;
+            case config_schema_1.StorageProvider.CLOUDINARY:
+                if (!storageConfig.accessKeyId || !storageConfig.secretAccessKey) {
+                    throw new Error('Cloudinary credentials are required');
+                }
+                this.adapter = new cloudinary_adapter_1.CloudinaryStorageAdapter({
+                    cloudName: storageConfig.bucket,
+                    apiKey: storageConfig.accessKeyId,
+                    apiSecret: storageConfig.secretAccessKey,
+                    folder: storageConfig.endpoint,
+                });
+                this.logger.log('Initialized Cloudinary storage adapter');
+                break;
+            default:
+                throw new Error(`Unknown storage provider: ${storageConfig.provider}`);
+        }
+    }
+    getAdapter() {
+        return this.adapter;
+    }
+};
+exports.StorageService = StorageService;
+exports.StorageService = StorageService = StorageService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_service_1.DBDockConfigService])
+], StorageService);
+//# sourceMappingURL=storage.service.js.map

package/dist/storage/storage.service.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+import { Logger as NestLogger } from '@nestjs/common';
+export declare class DBDockLogger extends NestLogger {
+    logBackupStart(backupId: string, type: string): void;
+    logBackupComplete(backupId: string, duration: number, size: number): void;
+    logBackupError(backupId: string, error: Error): void;
+    logRestoreStart(backupId: string, targetTime?: string): void;
+    logRestoreComplete(backupId: string, duration: number): void;
+    logRestoreError(backupId: string, error: Error): void;
+    logWalArchive(walFile: string): void;
+    logWalArchiveError(walFile: string, error: Error): void;
+    private formatBytes;
+}

package/dist/utils/logger.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DBDockLogger = void 0;
+const common_1 = require("@nestjs/common");
+class DBDockLogger extends common_1.Logger {
+    logBackupStart(backupId, type) {
+        this.log(`Backup started: ${backupId} (type: ${type})`);
+    }
+    logBackupComplete(backupId, duration, size) {
+        this.log(`Backup completed: ${backupId} (duration: ${duration}ms, size: ${this.formatBytes(size)})`);
+    }
+    logBackupError(backupId, error) {
+        this.error(`Backup failed: ${backupId} - ${error.message}`, error.stack);
+    }
+    logRestoreStart(backupId, targetTime) {
+        const timeInfo = targetTime ? ` to time: ${targetTime}` : '';
+        this.log(`Restore started: ${backupId}${timeInfo}`);
+    }
+    logRestoreComplete(backupId, duration) {
+        this.log(`Restore completed: ${backupId} (duration: ${duration}ms)`);
+    }
+    logRestoreError(backupId, error) {
+        this.error(`Restore failed: ${backupId} - ${error.message}`, error.stack);
+    }
+    logWalArchive(walFile) {
+        this.log(`WAL archived: ${walFile}`);
+    }
+    logWalArchiveError(walFile, error) {
+        this.error(`WAL archive failed: ${walFile} - ${error.message}`);
+    }
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+    }
+}
+exports.DBDockLogger = DBDockLogger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAAA,2CAAsD;AAEtD,MAAa,YAAa,SAAQ,eAAU;IAC1C,cAAc,CAAC,QAAgB,EAAE,IAAY;QAC3C,IAAI,CAAC,GAAG,CAAC,mBAAmB,QAAQ,WAAW,IAAI,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,iBAAiB,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAY;QAChE,IAAI,CAAC,GAAG,CACN,qBAAqB,QAAQ,eAAe,QAAQ,aAAa,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAC3F,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,KAAY;QAC3C,IAAI,CAAC,KAAK,CAAC,kBAAkB,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,eAAe,CAAC,QAAgB,EAAE,UAAmB;QACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,GAAG,CAAC,oBAAoB,QAAQ,GAAG,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;QACnD,IAAI,CAAC,GAAG,CAAC,sBAAsB,QAAQ,eAAe,QAAQ,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,eAAe,CAAC,QAAgB,EAAE,KAAY;QAC5C,IAAI,CAAC,KAAK,CAAC,mBAAmB,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,IAAI,CAAC,GAAG,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,kBAAkB,CAAC,OAAe,EAAE,KAAY;QAC9C,IAAI,CAAC,KAAK,CAAC,uBAAuB,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,CAAC,GAAG,IAAI,CAAC;QACf,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpD,OAAO,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;CACF;AA7CD,oCA6CC"}

package/dist/utils/stream.pipe.d.ts

@@ -0,0 +1,17 @@
+import { Transform, TransformCallback } from 'stream';
+export declare class CounterStream extends Transform {
+    private bytesProcessed;
+    _transform(chunk: unknown, encoding: BufferEncoding, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+    getBytesProcessed(): number;
+}
+export declare class ProgressStream extends Transform {
+    private bytesProcessed;
+    private lastReportedProgress;
+    private readonly reportInterval;
+    private readonly onProgress?;
+    constructor(reportIntervalBytes?: number, onProgress?: (bytes: number) => void);
+    _transform(chunk: unknown, encoding: BufferEncoding, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+    getBytesProcessed(): number;
+}

package/dist/utils/stream.pipe.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressStream = exports.CounterStream = void 0;
+const stream_1 = require("stream");
+class CounterStream extends stream_1.Transform {
+    bytesProcessed = 0;
+    _transform(chunk, encoding, callback) {
+        this.bytesProcessed += chunk.length;
+        this.push(chunk);
+        callback();
+    }
+    _flush(callback) {
+        callback();
+    }
+    getBytesProcessed() {
+        return this.bytesProcessed;
+    }
+}
+exports.CounterStream = CounterStream;
+class ProgressStream extends stream_1.Transform {
+    bytesProcessed = 0;
+    lastReportedProgress = 0;
+    reportInterval;
+    onProgress;
+    constructor(reportIntervalBytes = 1024 * 1024, onProgress) {
+        super();
+        this.reportInterval = reportIntervalBytes;
+        this.onProgress = onProgress;
+    }
+    _transform(chunk, encoding, callback) {
+        const buffer = chunk;
+        this.bytesProcessed += buffer.length;
+        if (this.bytesProcessed - this.lastReportedProgress >=
+            this.reportInterval) {
+            this.lastReportedProgress = this.bytesProcessed;
+            if (this.onProgress) {
+                this.onProgress(this.bytesProcessed);
+            }
+        }
+        this.push(chunk);
+        callback();
+    }
+    _flush(callback) {
+        if (this.onProgress && this.bytesProcessed > this.lastReportedProgress) {
+            this.onProgress(this.bytesProcessed);
+        }
+        callback();
+    }
+    getBytesProcessed() {
+        return this.bytesProcessed;
+    }
+}
+exports.ProgressStream = ProgressStream;
+//# sourceMappingURL=stream.pipe.js.map

package/dist/utils/stream.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.pipe.js","sourceRoot":"","sources":["../../src/utils/stream.pipe.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAEtD,MAAa,aAAc,SAAQ,kBAAS;IAClC,cAAc,GAAG,CAAC,CAAC;IAE3B,UAAU,CACR,KAAc,EACd,QAAwB,EACxB,QAA2B;QAE3B,IAAI,CAAC,cAAc,IAAK,KAAgB,CAAC,MAAM,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,MAAM,CAAC,QAA2B;QAChC,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AApBD,sCAoBC;AAED,MAAa,cAAe,SAAQ,kBAAS;IACnC,cAAc,GAAG,CAAC,CAAC;IACnB,oBAAoB,GAAG,CAAC,CAAC;IAChB,cAAc,CAAS;IACvB,UAAU,CAA2B;IAEtD,YACE,mBAAmB,GAAG,IAAI,GAAG,IAAI,EACjC,UAAoC;QAEpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,mBAAmB,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,UAAU,CACR,KAAc,EACd,QAAwB,EACxB,QAA2B;QAE3B,MAAM,MAAM,GAAG,KAAe,CAAC;QAC/B,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC;QAErC,IACE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,oBAAoB;YAC/C,IAAI,CAAC,cAAc,EACnB,CAAC;YACD,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,cAAc,CAAC;YAChD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,MAAM,CAAC,QAA2B;QAChC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvC,CAAC;QACD,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AA/CD,wCA+CC"}

package/dist/wal/postgres-config.helper.d.ts

@@ -0,0 +1,5 @@
+export declare class PostgresConfigHelper {
+    static getArchiveCommandScript(archivePath: string): string;
+    static getPostgresqlConfSettings(archivePath: string): string;
+    static getSetupInstructions(): string;
+}

package/dist/wal/postgres-config.helper.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresConfigHelper = void 0;
+class PostgresConfigHelper {
+    static getArchiveCommandScript(archivePath) {
+        return `
+#!/bin/bash
+# PostgreSQL WAL Archive Command Script
+# Generated by DBDock
+
+WAL_FILE="$1"
+WAL_PATH="$2"
+ARCHIVE_PATH="${archivePath}"
+
+# Create archive directory if it doesn't exist
+mkdir -p "$ARCHIVE_PATH"
+
+# Copy WAL file to archive location
+cp "$WAL_PATH" "$ARCHIVE_PATH/$WAL_FILE"
+
+# Signal DBDock to process this WAL file
+# You can integrate this with DBDock's WAL archiver
+# For now, we just copy it to the archive location
+
+exit 0
+`.trim();
+    }
+    static getPostgresqlConfSettings(archivePath) {
+        return `
+# PostgreSQL Configuration for DBDock WAL Archiving
+# Add these settings to postgresql.conf
+
+# Enable WAL archiving
+wal_level = replica
+archive_mode = on
+archive_command = 'test ! -f ${archivePath}/%f && cp %p ${archivePath}/%f'
+
+# Archive timeout (optional - archives WAL every 5 minutes even if not full)
+archive_timeout = 300
+
+# WAL segment size (default is 16MB)
+# Note: This is a compile-time setting and cannot be changed in postgresql.conf
+
+# For better PITR recovery
+full_page_writes = on
+`.trim();
+    }
+    static getSetupInstructions() {
+        return `
+# DBDock WAL Archiving Setup Instructions
+
+## 1. Configure PostgreSQL
+
+Add the following to your postgresql.conf:
+
+\`\`\`
+wal_level = replica
+archive_mode = on
+archive_command = 'test ! -f /path/to/archive/%f && cp %p /path/to/archive/%f'
+archive_timeout = 300
+\`\`\`
+
+## 2. Create Archive Directory
+
+\`\`\`bash
+mkdir -p /path/to/archive
+chown postgres:postgres /path/to/archive
+chmod 700 /path/to/archive
+\`\`\`
+
+## 3. Restart PostgreSQL
+
+\`\`\`bash
+sudo systemctl restart postgresql
+\`\`\`
+
+## 4. Verify Configuration
+
+\`\`\`sql
+SELECT name, setting FROM pg_settings WHERE name IN ('wal_level', 'archive_mode', 'archive_command');
+\`\`\`
+
+## 5. Monitor WAL Archiving
+
+\`\`\`sql
+SELECT * FROM pg_stat_archiver;
+\`\`\`
+
+## 6. Configure DBDock
+
+Enable PITR in your dbdock.config.json:
+
+\`\`\`json
+{
+  "pitr": {
+    "enabled": true,
+    "walIntervalSeconds": 300,
+    "retentionDays": 30
+  }
+}
+\`\`\`
+
+## 7. Archive WAL Files with DBDock
+
+You can manually archive WAL files or set up a cron job:
+
+\`\`\`bash
+# Archive all WAL files in the archive directory
+for wal in /path/to/archive/*; do
+  dbdock wal:archive --file "$wal"
+done
+\`\`\`
+`.trim();
+    }
+}
+exports.PostgresConfigHelper = PostgresConfigHelper;
+//# sourceMappingURL=postgres-config.helper.js.map

package/dist/wal/postgres-config.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-config.helper.js","sourceRoot":"","sources":["../../src/wal/postgres-config.helper.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;IAC/B,MAAM,CAAC,uBAAuB,CAAC,WAAmB;QAChD,OAAO;;;;;;;gBAOK,WAAW;;;;;;;;;;;;;CAa1B,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;IAED,MAAM,CAAC,yBAAyB,CAAC,WAAmB;QAClD,OAAO;;;;;;;+BAOoB,WAAW,gBAAgB,WAAW;;;;;;;;;;CAUpE,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;IAED,MAAM,CAAC,oBAAoB;QACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEV,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;CACF;AAjHD,oDAiHC"}