rac-delta 1.0.0

package/dist/core/pipelines/download-pipeline.d.ts

@@ -0,0 +1,142 @@
+import { ChunkSource, DeltaService, ReconstructionService, ValidationService } from '../services';
+import { HashStorageAdapter, UrlStorageAdapter } from '../adapters';
+import { ChunkUrlInfo, DeltaPlan, RDIndex } from '../models';
+import { RacDeltaConfig } from '../config';
+import { Nullish } from '../types';
+export declare enum UpdateStrategy {
+    /**
+     * Downloads every chunk before reconstruction and save chunks in memory.
+     * Perfect for fast connection and offline reconstruction.
+     *
+     * NOTE: For large updates this is not recommended, as could use a lot of memory
+     */
+    DownloadAllFirstToMemory = "download-all-first-to-memory",
+    /**
+     * Downloads chunks on demand while reconstruction.
+     * Useful for limited resourced environments or progressive streaming.
+     */
+    StreamFromNetwork = "stream-from-network",
+    /**
+     * Downloads every chunk before reconstruction and save chunks in disk to given path.
+     * Perfect for fast connection, fast disks and offline reconstruction.
+     */
+    DownloadAllFirstToDisk = "download-all-first-to-disk"
+}
+export interface DownloadOptions {
+    /**
+     * If true, downloads everything.
+     * If false, only new and modified chunks will be downloaded.
+     */
+    force?: Nullish<boolean>;
+    /**
+     * Path where chunks will be saved if `DownloadAllFirstToDisk` strategy is set.
+     */
+    chunksSavePath?: Nullish<string>;
+    /**
+     * If true, will search first an existing rd-index in local dir.
+     * This option is not recommended, as generating a new rd-index is always the best way to detect changes or corruption.
+     */
+    useExistingIndex?: Nullish<boolean>;
+    /**
+     * How many files will be reconstructed concurrently. (Default is 5)
+     */
+    fileReconstructionConcurrency?: Nullish<number>;
+    /**
+     * Minimum file size (in bytes) required to perform an **in-place reconstruction** instead of using a temporary file.
+     * Default: `400 * 1024 * 1024` (400 MB).
+     *
+     * **In-place reconstruction:**
+     * The existing file is opened and updated directly by overwriting only the modified or missing chunks.
+     *
+     * **.tmp reconstruction:**
+     * The file is fully rebuilt in a temporary `.tmp` location using all chunks (new and existing), then replaced over the original file.
+     *
+     * **When to use:**
+     * In-place reconstruction is recommended for **large files**, as it avoids rewriting the entire file and significantly reduces disk space usage.
+     * However, it may be **unsafe for certain formats** (e.g., ZIP archives or databases) that are sensitive to partial writes or corruption.
+     * To disable in-place reconstruction entirely, set this value to `0`.
+     */
+    inPlaceReconstructionThreshold?: Nullish<number>;
+    /**
+     * Optional callback to inform progress.
+     */
+    onProgress?: (type: 'download' | 'deleting' | 'reconstructing', progress: number, diskUsage?: Nullish<number>, speed?: Nullish<number>) => void;
+    /**
+     * Optinal callback for state changes.
+     */
+    onStateChange?: (state: 'downloading' | 'reconstructing' | 'cleaning' | 'scanning') => void;
+}
+export declare abstract class DownloadPipeline {
+    protected updateProgress(value: number, state: 'download' | 'reconstructing' | 'deleting', diskUsage?: Nullish<number>, speed?: Nullish<number>, options?: Nullish<DownloadOptions>): void;
+    protected changeState(state: 'downloading' | 'reconstructing' | 'cleaning' | 'scanning', options?: Nullish<DownloadOptions>): void;
+    /**
+     * This method will create a rd-index.json of a given directory, scanning files and generating hashes.
+     *
+     * @param dir directory to generate index.
+     */
+    abstract loadLocalIndex(dir: string): Promise<RDIndex>;
+    /**
+     * This method will find for a rd-index.json if exists on given folder.
+     *
+     * @param localDir directory to find index.
+     */
+    abstract findLocalIndex(localDir: string): Promise<RDIndex | null>;
+    /**
+     * This method will save the new local index on given folder.
+     *
+     * @param localDir directory to save index.
+     * @param index the rd-index.json object.
+     */
+    abstract saveLocalIndex(localDir: string, index: RDIndex): Promise<void>;
+    /**
+     * This method will check for reconstructed files, verifying its hash and obsolete chunks.
+     * If obsolete chunks are still present, it will delete them, and reconstruct file again if needed.
+     *
+     * @param plan the `DeltaPlan` generated by delta.compare of the two rd-index.json for the download
+     * @param localDir directory to check files
+     * @param remoteIndex the remote index for reference
+     * @param chunkSource `ChunkSource` to download corrupt chunks in case of invalid files.
+     */
+    abstract verifyAndDeleteObsoleteChunks(plan: DeltaPlan, localDir: string, remoteIndex: RDIndex, chunkSource: ChunkSource, options?: Nullish<DownloadOptions>): Promise<{
+        deletedFiles: string[];
+        verifiedFiles: string[];
+        rebuiltFiles: string[];
+    }>;
+}
+export declare abstract class HashDownloadPipeline extends DownloadPipeline {
+    protected readonly storage: HashStorageAdapter;
+    protected readonly delta: DeltaService;
+    protected readonly reconstruction: ReconstructionService;
+    protected readonly validation: ValidationService;
+    protected readonly config: RacDeltaConfig;
+    constructor(storage: HashStorageAdapter, delta: DeltaService, reconstruction: ReconstructionService, validation: ValidationService, config: RacDeltaConfig);
+    abstract execute(localDir: string, strategy: UpdateStrategy, remoteIndex?: Nullish<RDIndex>, options?: Nullish<DownloadOptions>): Promise<void>;
+    /**
+     * This method will download first all needed chunks for download, and save them temporary on disk or memory.
+     *
+     * Will return `ChunkSource`, ChunkSources will be needed to reconstruct files, this method will ONLY return
+     * memory or disk chunk sources for offline reconstruction, if you use a storage like S3, you can omit this
+     * and use directly the StorageChunkSource with `reconstruction.reconstructAll()` if you prefer.
+     *
+     * (Using StorageChunkSource will download chunks and reconstruct file at same time, concurrently)
+     *
+     * @param plan the `DeltaPlan` generated by delta.compare of the two rd-index.json for the download
+     * @param target disk or memory, where chunks will be saved temporary
+     * @param options
+     */
+    abstract downloadAllMissingChunks(plan: DeltaPlan, target: 'memory' | 'disk', options?: Nullish<DownloadOptions>): Promise<ChunkSource>;
+}
+export declare abstract class UrlDownloadPipeline extends DownloadPipeline {
+    protected readonly storage: UrlStorageAdapter;
+    protected readonly reconstruction: ReconstructionService;
+    protected readonly validation: ValidationService;
+    protected readonly delta: DeltaService;
+    protected readonly config: RacDeltaConfig;
+    constructor(storage: UrlStorageAdapter, reconstruction: ReconstructionService, validation: ValidationService, delta: DeltaService, config: RacDeltaConfig);
+    abstract execute(localDir: string, urls: {
+        downloadUrls: Record<string, ChunkUrlInfo>;
+        indexUrl: string;
+    }, strategy: UpdateStrategy, plan?: Nullish<DeltaPlan>, options?: Nullish<DownloadOptions>): Promise<void>;
+    abstract downloadAllMissingChunks(downloadUrls: Record<string, ChunkUrlInfo>, target: 'memory' | 'disk', options?: Nullish<DownloadOptions>): Promise<ChunkSource>;
+}
+//# sourceMappingURL=download-pipeline.d.ts.map

package/dist/core/pipelines/download-pipeline.d.ts.map

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

package/dist/core/pipelines/download-pipeline.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlDownloadPipeline = exports.HashDownloadPipeline = exports.DownloadPipeline = exports.UpdateStrategy = void 0;
+var UpdateStrategy;
+(function (UpdateStrategy) {
+    /**
+     * Downloads every chunk before reconstruction and save chunks in memory.
+     * Perfect for fast connection and offline reconstruction.
+     *
+     * NOTE: For large updates this is not recommended, as could use a lot of memory
+     */
+    UpdateStrategy["DownloadAllFirstToMemory"] = "download-all-first-to-memory";
+    /**
+     * Downloads chunks on demand while reconstruction.
+     * Useful for limited resourced environments or progressive streaming.
+     */
+    UpdateStrategy["StreamFromNetwork"] = "stream-from-network";
+    /**
+     * Downloads every chunk before reconstruction and save chunks in disk to given path.
+     * Perfect for fast connection, fast disks and offline reconstruction.
+     */
+    UpdateStrategy["DownloadAllFirstToDisk"] = "download-all-first-to-disk";
+})(UpdateStrategy || (exports.UpdateStrategy = UpdateStrategy = {}));
+class DownloadPipeline {
+    updateProgress(value, state, diskUsage, speed, options) {
+        options?.onProgress?.(state, value, diskUsage, speed);
+    }
+    changeState(state, options) {
+        options?.onStateChange?.(state);
+    }
+}
+exports.DownloadPipeline = DownloadPipeline;
+class HashDownloadPipeline extends DownloadPipeline {
+    storage;
+    delta;
+    reconstruction;
+    validation;
+    config;
+    constructor(storage, delta, reconstruction, validation, config) {
+        super();
+        this.storage = storage;
+        this.delta = delta;
+        this.reconstruction = reconstruction;
+        this.validation = validation;
+        this.config = config;
+    }
+}
+exports.HashDownloadPipeline = HashDownloadPipeline;
+class UrlDownloadPipeline extends DownloadPipeline {
+    storage;
+    reconstruction;
+    validation;
+    delta;
+    config;
+    constructor(storage, reconstruction, validation, delta, config) {
+        super();
+        this.storage = storage;
+        this.reconstruction = reconstruction;
+        this.validation = validation;
+        this.delta = delta;
+        this.config = config;
+    }
+}
+exports.UrlDownloadPipeline = UrlDownloadPipeline;

package/dist/core/pipelines/index.d.ts

@@ -0,0 +1,3 @@
+export * from './download-pipeline';
+export * from './upload-pipeline';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/pipelines/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/pipelines/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/core/pipelines/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./download-pipeline"), exports);
+__exportStar(require("./upload-pipeline"), exports);

package/dist/core/pipelines/upload-pipeline.d.ts

@@ -0,0 +1,60 @@
+import { HashStorageAdapter, UrlStorageAdapter } from '../adapters';
+import { ChunkUrlInfo, DeltaPlan, RDIndex } from '../models';
+import { DeltaService } from '../services';
+import { RacDeltaConfig } from '../config';
+import { Nullish } from '../types';
+export type UploadState = 'uploading' | 'comparing' | 'cleaning' | 'finalizing' | 'scanning';
+export interface UploadOptions {
+    /**
+     * If true, forces complete upload even if remote index exists.
+     * If false, only new and modified chunks will be uploaded.
+     */
+    force?: Nullish<boolean>;
+    /**
+     * If true and no remote index found, abort upload.
+     * If false (default), uploads everything if no remote index found.
+     */
+    requireRemoteIndex?: Nullish<boolean>;
+    /**
+     * Files or directories that must be ignored when creating the rd-index.json.
+     * Example: '*.ts', '/folder/*', 'ignorefile.txt'...
+     */
+    ignorePatterns?: Nullish<string[]>;
+    /**
+     * Optional callback to inform progress.
+     */
+    onProgress?: (type: 'upload' | 'deleting', progress: number, speed?: Nullish<number>) => void;
+    /**
+     * Optional callback for state changes.
+     */
+    onStateChange?: (state: UploadState) => void;
+}
+export declare abstract class UploadPipeline {
+    protected updateProgress(value: number, state: 'upload' | 'deleting', speed?: Nullish<number>, options?: Nullish<UploadOptions>): void;
+    protected changeState(state: UploadState, options?: UploadOptions): void;
+}
+export declare abstract class HashUploadPipeline extends UploadPipeline {
+    protected readonly storage: HashStorageAdapter;
+    protected readonly delta: DeltaService;
+    protected readonly config: RacDeltaConfig;
+    constructor(storage: HashStorageAdapter, delta: DeltaService, config: RacDeltaConfig);
+    abstract execute(directory: string, remoteIndex?: Nullish<RDIndex>, options?: Nullish<UploadOptions>): Promise<RDIndex>;
+    abstract scanDirectory(dir: string, ignorePatterns?: Nullish<string[]>): Promise<RDIndex>;
+    abstract uploadMissingChunks(plan: DeltaPlan, baseDir: string, force: boolean, options?: Nullish<UploadOptions>): Promise<void>;
+    abstract uploadIndex(index: RDIndex): Promise<void>;
+    abstract deleteObsoleteChunks(plan: DeltaPlan, options?: Nullish<UploadOptions>): Promise<void>;
+}
+export declare abstract class UrlUploadPipeline extends UploadPipeline {
+    protected readonly storage: UrlStorageAdapter;
+    protected readonly config: RacDeltaConfig;
+    constructor(storage: UrlStorageAdapter, config: RacDeltaConfig);
+    abstract execute(localIndex: RDIndex, urls: {
+        uploadUrls: Record<string, ChunkUrlInfo>;
+        deleteUrls?: Nullish<string[]>;
+        indexUrl: string;
+    }, options?: Nullish<UploadOptions>): Promise<RDIndex>;
+    abstract uploadMissingChunks(uploadUrls: Record<string, ChunkUrlInfo>, options?: Nullish<UploadOptions>): Promise<void>;
+    abstract uploadIndex(index: RDIndex, uploadUrl: string): Promise<void>;
+    abstract deleteObsoleteChunks(deleteUrls: string[], options?: Nullish<UploadOptions>): Promise<void>;
+}
+//# sourceMappingURL=upload-pipeline.d.ts.map

package/dist/core/pipelines/upload-pipeline.d.ts.map

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

package/dist/core/pipelines/upload-pipeline.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlUploadPipeline = exports.HashUploadPipeline = exports.UploadPipeline = void 0;
+class UploadPipeline {
+    updateProgress(value, state, speed, options) {
+        options?.onProgress?.(state, value, speed);
+    }
+    changeState(state, options) {
+        options?.onStateChange?.(state);
+    }
+}
+exports.UploadPipeline = UploadPipeline;
+class HashUploadPipeline extends UploadPipeline {
+    storage;
+    delta;
+    config;
+    constructor(storage, delta, config) {
+        super();
+        this.storage = storage;
+        this.delta = delta;
+        this.config = config;
+    }
+}
+exports.HashUploadPipeline = HashUploadPipeline;
+class UrlUploadPipeline extends UploadPipeline {
+    storage;
+    config;
+    constructor(storage, config) {
+        super();
+        this.storage = storage;
+        this.config = config;
+    }
+}
+exports.UrlUploadPipeline = UrlUploadPipeline;

package/dist/core/services/delta-service.d.ts

@@ -0,0 +1,76 @@
+import { DeltaPlan, FileEntry, RDIndex } from '../models';
+import { Nullish } from '../types';
+export interface AsyncChunkStream extends AsyncIterable<Uint8Array> {
+    nextChunk(): Promise<Uint8Array | null>;
+    reset?(): Promise<void>;
+    close?(): Promise<void>;
+}
+export interface DeltaService {
+    /**
+     * Creates an RDIndex for a given directory.
+     *
+     * This process scans all files recursively, splits them into chunks,
+     * hashes each chunk (using HasherService.hashStream), and builds
+     * the rd-index.json structure.
+     *
+     * @param rootPath the path of the directory
+     * @param chunkSize The size (in bytes) chunks will have, recommended is 1024.
+     *
+     */
+    createIndexFromDirectory(rootPath: string, chunkSize: number, concurrency?: Nullish<number>, ignorePatterns?: Nullish<string[]>): Promise<RDIndex>;
+    /**
+     * Creates a FileEntry from a readable data stream.
+     *
+     * This method is used when the data source is remote or does not
+     * exist as a physical file in the local filesystem.
+     *
+     * It reads the stream in chunks (chunk size must be defined by source), hashes each one (using HasherService.hashStream),
+     * and produces a `FileEntry` compatible with RDIndex.
+     *
+     * @param stream An async stream providing file chunks.
+     * @param path Relative path of the source file
+     */
+    createFileEntryFromStream(stream: AsyncChunkStream, path: string): Promise<FileEntry>;
+    /**
+     * Compare two rd-index.json and generate a DeltaPlan. (Neutral method, for more specific methods use compareForUpload or compareForDownload)
+     *
+     * @param source The rd-index from source to compare (Example: local)
+     * @param target The rd-index from target to compare (Example: remote server)
+     *
+     * Local -> Remote = upload comparison.
+     *
+     * Remote -> Local = download comparison.
+     *
+     * DeltaPlan Explanation:
+     *  - missing chunks: chunks that exist in `source` but are missing in `target`
+     *                   (i.e. need to be transferred from source -> target).
+     *  - reused chunks: chunks present in target that can be reused.
+     *
+     *  - obsolete chunks: chunks that no longer exists in source and needs to be removed from target.
+     *    (considerations must be taken for deduplication, as for uploads, if a chunk is used for multiple files it could not be marked as obsolete)
+     */
+    compare(source: RDIndex, target: RDIndex | null): DeltaPlan;
+    /**
+     * Merges 2 `DeltaPlan`
+     *
+     * @param base base `DeltaPlan`
+     * @param updates `DeltaPlan` to merge with base
+     */
+    mergePlans(base: DeltaPlan, updates: DeltaPlan): DeltaPlan;
+    /**
+     * This wrapper will compare rd-indexes ready for upload update. It can check deduplication correctly with obsolete chunks.
+     * (Example: 1 chunk is used in 2 files but one file no longer uses the chunk => it IS NOT A OBSOLETE CHUNK)
+     *
+     * @param localIndex the local rd-index
+     * @param remoteIndex the remote rd-index (null to upload everything)
+     */
+    compareForUpload(localIndex: RDIndex, remoteIndex: RDIndex | null): Promise<DeltaPlan>;
+    /**
+     * This wrapper will compare rd-indexes ready for download update
+     *
+     * @param localIndex the local rd-index (null to download everything)
+     * @param remoteIndex the remote rd-index
+     */
+    compareForDownload(localIndex: RDIndex | null, remoteIndex: RDIndex): Promise<DeltaPlan>;
+}
+//# sourceMappingURL=delta-service.d.ts.map

package/dist/core/services/delta-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/delta-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,gBAAiB,SAAQ,aAAa,CAAC,UAAU,CAAC;IACjE,SAAS,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;OAUG;IACH,wBAAwB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAC7B,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtF;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5D;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAE3D;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACvF;;;;;OAKG;IACH,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1F"}

package/dist/core/services/delta-service.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/services/hasher-service.d.ts

@@ -0,0 +1,47 @@
+import { AsyncChunkStream } from './delta-service';
+import { Chunk, FileEntry } from '../models';
+export interface StreamingHasher {
+    update(data: Uint8Array | Buffer): void;
+    digest(encoding?: 'hex'): string;
+}
+export interface HasherService {
+    /**
+     * Will return a `FileEntry` of given file, calculating its hash and chunk hashes.
+     *
+     * @param filePath The relative path of the file (ex 'dir/file.txt').
+     * @param rootDir The root dir where the index is. (ex 'dir').
+     * @param chunkSize The size (in bytes) chunks will have, recommended is 1MB (1024 * 1024).
+     *
+     * **IMPORTANT NOTE:** selected chunkSize must be the same in all operations of rac-delta
+     */
+    hashFile(filePath: string, rootDir: string, chunkSize: number): Promise<FileEntry>;
+    /**
+     * Will process a stream of Chunks and return an array of hashed Chunks
+     *
+     * @param stream
+     * @param onChunk callback that returns the processed bytes
+     */
+    hashStream(stream: AsyncChunkStream, onChunk?: (chunk: Uint8Array) => void): Promise<Chunk[]>;
+    /**
+     * Returns a hash of a buffer
+     *
+     * @param data
+     */
+    hashBuffer(data: Uint8Array): Promise<string>;
+    /**
+     * Verifies that a chunk has the expected hash
+     *
+     * @param data chunk data
+     * @param expectedHash
+     */
+    verifyChunk(data: Uint8Array, expectedHash: string): Promise<boolean>;
+    /**
+     * Verifies that a file has the expected hash
+     *
+     * @param path file path
+     * @param expectedHash
+     */
+    verifyFile(path: string, expectedHash: string): Promise<boolean>;
+    createStreamingHasher(): Promise<StreamingHasher>;
+}
+//# sourceMappingURL=hasher-service.d.ts.map

package/dist/core/services/hasher-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasher-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/hasher-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IAExC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE9F;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACnD"}

package/dist/core/services/hasher-service.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/services/index.d.ts

@@ -0,0 +1,5 @@
+export * from './delta-service';
+export * from './hasher-service';
+export * from './reconstruction-service';
+export * from './validation-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/core/services/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./delta-service"), exports);
+__exportStar(require("./hasher-service"), exports);
+__exportStar(require("./reconstruction-service"), exports);
+__exportStar(require("./validation-service"), exports);

package/dist/core/services/reconstruction-service.d.ts

@@ -0,0 +1,99 @@
+import { Readable } from 'stream';
+import { FileEntry, DeltaPlan } from '../models';
+import { Nullish } from '../types';
+export declare const DEFAULT_IN_PLACE_RECONSTRUCTION_THRESHOLD: number;
+export interface ReconstructionOptions {
+    /**
+     * Force to rebuild even if hash file matches.
+     */
+    forceRebuild?: Nullish<boolean>;
+    /**
+     * Verifies the reconstructed file hash after finishing.
+     * If hash does not match, an error is thrown.
+     */
+    verifyAfterRebuild?: Nullish<boolean>;
+    /**
+     * Minimum file size (in bytes) required to perform an **in-place reconstruction** instead of using a temporary file.
+     * Default: `400 * 1024 * 1024` (400 MB).
+     *
+     * **In-place reconstruction:**
+     * The existing file is opened and updated directly by overwriting only the modified or missing chunks.
+     *
+     * **.tmp reconstruction:**
+     * The file is fully rebuilt in a temporary `.tmp` location using all chunks (new and existing), then replaced over the original file.
+     *
+     * **When to use:**
+     * In-place reconstruction is recommended for **large files**, as it avoids rewriting the entire file and significantly reduces disk space usage.
+     * However, it may be **unsafe for certain formats** (e.g., ZIP archives or databases) that are sensitive to partial writes or corruption.
+     * To disable in-place reconstruction entirely, set this value to `0`.
+     */
+    inPlaceReconstructionThreshold?: Nullish<number>;
+    /**
+     * How many files will reconstruct concurrently (default value is 5)
+     */
+    fileConcurrency?: Nullish<number>;
+    /**
+     * Callback that returns disk usage and optional network speed (only for storage chunk sources via streaming download-reconstruction)
+     *
+     * @param reconstructProgress current reconstruction progress
+     * @param diskSpeed speed of disk write in bytes per second
+     * @param networkProgress current network progress if any
+     * @param networkSpeed download speed in bytes per second
+     */
+    onProgress?: (reconstructProgress: number, diskSpeed: number, networkProgress?: Nullish<number>, networkSpeed?: Nullish<number>) => void;
+}
+export interface ChunkSource {
+    /**
+     * Gets a chunk from the source.
+     */
+    getChunk(hash: string): Promise<Buffer>;
+    /**
+     * Retrieves multiple chunks concurrently.
+     */
+    getChunks?(hashes: string[], options?: Nullish<{
+        concurrency?: number;
+    }>): Promise<Map<string, Buffer>>;
+    /**
+     * Streams file chunks from storage concurrently.
+     * Can preserve original order or emit as workers complete.
+     *
+     * @param options.concurrency Number of parallel fetches (default 8)
+     * @param options.preserveOrder Whether to yield in input order (default true)
+     */
+    streamChunks?(hashes: string[], options?: Nullish<{
+        concurrency?: number;
+        preserveOrder?: boolean;
+    }>): AsyncGenerator<{
+        hash: string;
+        data: Readable;
+    }>;
+}
+export interface ReconstructionService {
+    /**
+     * Reconstructs a file in disk.
+     * Able to reconstruct a new file or an existing file.
+     *
+     * @param entry The `FileEntry` containing the list of chunks and path of the file
+     * @param outputPath The path where the file will be reconstructed.
+     * @param chunkSource the source implementations of the chunks
+     * @param options optional parameters for the reconstruction
+     */
+    reconstructFile(entry: FileEntry, outputPath: string, chunkSource: ChunkSource, options?: Nullish<ReconstructionOptions>): Promise<void>;
+    /**
+     * Reconstructs all files from a DeltaPlan in disk.
+     *
+     * @param plan The DeltaPlan containing the list of files and chunks.
+     * @param outputDir The dir where the files will be reconstructed.
+     * @param chunkSource the source implementations of the chunks
+     * @param options optional parameters for the reconstruction
+     */
+    reconstructAll(plan: DeltaPlan, outputDir: string, chunkSource: ChunkSource, options?: Nullish<ReconstructionOptions>): Promise<void>;
+    /**
+     * Reconstructs a file to stream.
+     *
+     * @param entry The FileEntry containing the list of chunks of the file
+     * @param chunkSource the source implementations of the chunks
+     */
+    reconstructToStream(entry: FileEntry, chunkSource: ChunkSource): Promise<Readable>;
+}
+//# sourceMappingURL=reconstruction-service.d.ts.map

package/dist/core/services/reconstruction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruction-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/reconstruction-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,eAAO,MAAM,yCAAyC,QAAoB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CACX,mBAAmB,EAAE,MAAM,EAC3B,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EACjC,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAC3B,IAAI,CAAC;CACX;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,GACnE,cAAc,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,eAAe,CACb,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,cAAc,CACZ,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACpF"}

package/dist/core/services/reconstruction-service.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_IN_PLACE_RECONSTRUCTION_THRESHOLD = void 0;
+exports.DEFAULT_IN_PLACE_RECONSTRUCTION_THRESHOLD = 400 * 1024 * 1024; // 400MB

package/dist/core/services/validation-service.d.ts

@@ -0,0 +1,18 @@
+import { FileEntry, RDIndex } from '../models';
+export interface ValidationService {
+    /**
+     * Will validate a given file with its `FileEntry`
+     *
+     * @param entry
+     * @param path path of the file to validate
+     */
+    validateFile(entry: FileEntry, path: string): Promise<boolean>;
+    /**
+     * Will validate all files of a `RdIndex`
+     *
+     * @param index rd-index
+     * @param basePath directory of the files
+     */
+    validateIndex(index: RDIndex, basePath: string): Promise<boolean>;
+}
+//# sourceMappingURL=validation-service.d.ts.map