@filen/sync 0.1.1

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const SYNC_INTERVAL = 5000;

package/dist/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_INTERVAL = void 0;
+exports.SYNC_INTERVAL = 5000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG,IAAI,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import type { SyncPair } from "./types";
+import { type FilenSDKConfig } from "@filen/sdk";
+/**
+ * SyncWorker
+ * @date 2/23/2024 - 5:50:56 AM
+ *
+ * @export
+ * @class SyncWorker
+ * @typedef {SyncWorker}
+ */
+export declare class SyncWorker {
+    private readonly syncPairs;
+    private readonly syncs;
+    private readonly dbPath;
+    private readonly sdkConfig;
+    /**
+     * Creates an instance of SyncWorker.
+     *
+     * @constructor
+     * @public
+     * @param {{ syncPairs: SyncPair[]; dbPath: string; sdkConfig: FilenSDKConfig }} param0
+     * @param {{}} param0.syncPairs
+     * @param {string} param0.dbPath
+     * @param {FilenSDKConfig} param0.sdkConfig
+     */
+    constructor({ syncPairs, dbPath, sdkConfig }: {
+        syncPairs: SyncPair[];
+        dbPath: string;
+        sdkConfig: FilenSDKConfig;
+    });
+    /**
+     * Initialize the Sync worker.
+     * @date 2/23/2024 - 5:51:12 AM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    initialize(): Promise<void>;
+}
+export default SyncWorker;

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncWorker = void 0;
+const sync_1 = __importDefault(require("./lib/sync"));
+/**
+ * SyncWorker
+ * @date 2/23/2024 - 5:50:56 AM
+ *
+ * @export
+ * @class SyncWorker
+ * @typedef {SyncWorker}
+ */
+class SyncWorker {
+    /**
+     * Creates an instance of SyncWorker.
+     *
+     * @constructor
+     * @public
+     * @param {{ syncPairs: SyncPair[]; dbPath: string; sdkConfig: FilenSDKConfig }} param0
+     * @param {{}} param0.syncPairs
+     * @param {string} param0.dbPath
+     * @param {FilenSDKConfig} param0.sdkConfig
+     */
+    constructor({ syncPairs, dbPath, sdkConfig }) {
+        this.syncs = {};
+        this.syncPairs = syncPairs;
+        this.dbPath = dbPath;
+        this.sdkConfig = sdkConfig;
+    }
+    /**
+     * Initialize the Sync worker.
+     * @date 2/23/2024 - 5:51:12 AM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    async initialize() {
+        const promises = [];
+        for (const pair of this.syncPairs) {
+            if (!this.syncs[pair.uuid]) {
+                this.syncs[pair.uuid] = new sync_1.default({
+                    syncPair: pair,
+                    dbPath: this.dbPath,
+                    sdkConfig: this.sdkConfig
+                });
+                promises.push(this.syncs[pair.uuid].initialize());
+            }
+        }
+        await Promise.all(promises);
+    }
+}
+exports.SyncWorker = SyncWorker;
+exports.default = SyncWorker;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,sDAA6B;AAG7B;;;;;;;GAOG;AACH,MAAa,UAAU;IAMtB;;;;;;;;;OASG;IACH,YAAmB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAwE;QAdxG,UAAK,GAAyB,EAAE,CAAA;QAehD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,UAAU;QACtB,MAAM,QAAQ,GAAoB,EAAE,CAAA;QAEpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,cAAI,CAAC;oBAChC,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;iBACzB,CAAC,CAAA;gBAEF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,UAAU,EAAE,CAAC,CAAA;YACnD,CAAC;QACF,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC;CACD;AA/CD,gCA+CC;AAED,kBAAe,UAAU,CAAA"}

package/dist/lib/deltas.d.ts

@@ -0,0 +1,106 @@
+import type Sync from "./sync";
+import type { LocalTree } from "./filesystems/local";
+import type { RemoteTree } from "./filesystems/remote";
+export type Delta = {
+    path: string;
+} & ({
+    type: "uploadFile";
+} | {
+    type: "createRemoteDirectory";
+} | {
+    type: "createLocalDirectory";
+} | {
+    type: "deleteLocalFile";
+} | {
+    type: "deleteRemoteFile";
+} | {
+    type: "deleteLocalDirectory";
+} | {
+    type: "deleteRemoteDirectory";
+} | {
+    type: "downloadFile";
+} | {
+    type: "moveLocalFile";
+    from: string;
+    to: string;
+} | {
+    type: "renameLocalFile";
+    from: string;
+    to: string;
+} | {
+    type: "moveRemoteFile";
+    from: string;
+    to: string;
+} | {
+    type: "renameRemoteFile";
+    from: string;
+    to: string;
+} | {
+    type: "renameRemoteDirectory";
+    from: string;
+    to: string;
+} | {
+    type: "renameLocalDirectory";
+    from: string;
+    to: string;
+} | {
+    type: "moveRemoteDirectory";
+    from: string;
+    to: string;
+} | {
+    type: "moveLocalFile";
+    from: string;
+    to: string;
+} | {
+    type: "moveLocalDirectory";
+    from: string;
+    to: string;
+});
+/**
+ * Deltas
+ * @date 3/1/2024 - 11:11:32 PM
+ *
+ * @export
+ * @class Deltas
+ * @typedef {Deltas}
+ */
+export declare class Deltas {
+    private readonly sync;
+    /**
+     * Creates an instance of Deltas.
+     * @date 3/1/2024 - 11:11:36 PM
+     *
+     * @constructor
+     * @public
+     * @param {{ sync: Sync }} param0
+     * @param {Sync} param0.sync
+     */
+    constructor({ sync }: {
+        sync: Sync;
+    });
+    /**
+     * Process the directory trees and return all sync deltas.
+     * @date 3/2/2024 - 8:42:25 AM
+     *
+     * @public
+     * @async
+     * @param {{
+     * 		currentLocalTree: LocalTree
+     * 		currentRemoteTree: RemoteTree
+     * 		previousLocalTree: LocalTree
+     * 		previousRemoteTree: RemoteTree
+     * 	}} param0
+     * @param {LocalTree} param0.currentLocalTree
+     * @param {RemoteTree} param0.currentRemoteTree
+     * @param {LocalTree} param0.previousLocalTree
+     * @param {RemoteTree} param0.previousRemoteTree
+     * @returns {Promise<Delta[]>}
+     */
+    process({ currentLocalTree, currentRemoteTree, previousLocalTree, previousRemoteTree }: {
+        currentLocalTree: LocalTree;
+        currentRemoteTree: RemoteTree;
+        previousLocalTree: LocalTree;
+        previousRemoteTree: RemoteTree;
+    }): Promise<Delta[]>;
+}
+export default Deltas;

package/dist/lib/deltas.js

@@ -0,0 +1,217 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deltas = void 0;
+const path_1 = __importDefault(require("path"));
+/**
+ * Deltas
+ * @date 3/1/2024 - 11:11:32 PM
+ *
+ * @export
+ * @class Deltas
+ * @typedef {Deltas}
+ */
+class Deltas {
+    /**
+     * Creates an instance of Deltas.
+     * @date 3/1/2024 - 11:11:36 PM
+     *
+     * @constructor
+     * @public
+     * @param {{ sync: Sync }} param0
+     * @param {Sync} param0.sync
+     */
+    constructor({ sync }) {
+        this.sync = sync;
+    }
+    /**
+     * Process the directory trees and return all sync deltas.
+     * @date 3/2/2024 - 8:42:25 AM
+     *
+     * @public
+     * @async
+     * @param {{
+     * 		currentLocalTree: LocalTree
+     * 		currentRemoteTree: RemoteTree
+     * 		previousLocalTree: LocalTree
+     * 		previousRemoteTree: RemoteTree
+     * 	}} param0
+     * @param {LocalTree} param0.currentLocalTree
+     * @param {RemoteTree} param0.currentRemoteTree
+     * @param {LocalTree} param0.previousLocalTree
+     * @param {RemoteTree} param0.previousRemoteTree
+     * @returns {Promise<Delta[]>}
+     */
+    async process({ currentLocalTree, currentRemoteTree, previousLocalTree, previousRemoteTree }) {
+        const deltas = [];
+        const pathsAdded = {};
+        // Local file/directory move/rename
+        for (const inode in currentLocalTree.inodes) {
+            const currentItem = currentLocalTree.inodes[inode];
+            const previousItem = previousLocalTree.inodes[inode];
+            if (!currentItem || !previousItem || pathsAdded[currentItem.path] || pathsAdded[previousItem.path]) {
+                continue;
+            }
+            // Path from current item changed, it was either renamed or moved
+            if (currentItem.path !== previousItem.path) {
+                const currentItemParentPath = path_1.default.posix.dirname(currentItem.path);
+                const previousItemParentPath = path_1.default.posix.dirname(previousItem.path);
+                const currentItemParent = currentLocalTree.tree[currentItemParentPath];
+                const previousItemParent = previousLocalTree.tree[previousItemParentPath];
+                const currentItemName = path_1.default.posix.basename(currentItem.path);
+                const previousItemName = path_1.default.posix.basename(previousItem.path);
+                // Names changed
+                if (currentItemName !== previousItemName) {
+                    deltas.push({
+                        type: currentItem.type === "directory" ? "renameRemoteDirectory" : "renameRemoteFile",
+                        path: currentItem.path,
+                        from: previousItem.path,
+                        to: currentItem.path
+                    });
+                }
+                pathsAdded[currentItem.path] = true;
+                pathsAdded[previousItem.path] = true;
+                // Parents did not change, continue
+                if ((currentItemParent === null || currentItemParent === void 0 ? void 0 : currentItemParent.inode) === (previousItemParent === null || previousItemParent === void 0 ? void 0 : previousItemParent.inode)) {
+                    continue;
+                }
+                // Item was also moved
+                deltas.push({
+                    type: currentItem.type === "directory" ? "moveRemoteDirectory" : "moveRemoteFile",
+                    path: currentItem.path,
+                    from: previousItem.path,
+                    to: currentItem.path
+                });
+            }
+        }
+        // Remote file/directory move/rename
+        for (const uuid in currentRemoteTree.uuids) {
+            const currentItem = currentRemoteTree.uuids[uuid];
+            const previousItem = currentRemoteTree.uuids[uuid];
+            if (!currentItem || !previousItem || pathsAdded[currentItem.path] || pathsAdded[previousItem.path]) {
+                continue;
+            }
+            // Path from current item changed, it was either renamed or moved
+            if (currentItem.path !== previousItem.path) {
+                const currentItemParentPath = path_1.default.posix.dirname(currentItem.path);
+                const previousItemParentPath = path_1.default.posix.dirname(previousItem.path);
+                const currentItemParent = currentRemoteTree.tree[currentItemParentPath];
+                const previousItemParent = previousRemoteTree.tree[previousItemParentPath];
+                const currentItemName = path_1.default.posix.basename(currentItem.path);
+                const previousItemName = path_1.default.posix.basename(previousItem.path);
+                // Names changed
+                if (currentItemName !== previousItemName) {
+                    deltas.push({
+                        type: currentItem.type === "directory" ? "renameRemoteDirectory" : "renameRemoteFile",
+                        path: currentItem.path,
+                        from: previousItem.path,
+                        to: currentItem.path
+                    });
+                }
+                pathsAdded[currentItem.path] = true;
+                pathsAdded[previousItem.path] = true;
+                // Parents did not change, continue
+                if ((currentItemParent === null || currentItemParent === void 0 ? void 0 : currentItemParent.uuid) === (previousItemParent === null || previousItemParent === void 0 ? void 0 : previousItemParent.uuid)) {
+                    continue;
+                }
+                // Item was also moved
+                deltas.push({
+                    type: currentItem.type === "directory" ? "moveRemoteDirectory" : "moveRemoteFile",
+                    path: currentItem.path,
+                    from: previousItem.path,
+                    to: currentItem.path
+                });
+            }
+        }
+        // Local deletions
+        for (const path in previousLocalTree.tree) {
+            if (pathsAdded[path]) {
+                continue;
+            }
+            const previousLocalItem = previousLocalTree.tree[path];
+            const currentLocalItem = currentLocalTree.tree[path];
+            if (!currentLocalItem && previousLocalItem) {
+                deltas.push({
+                    type: previousLocalItem.type === "directory" ? "deleteRemoteDirectory" : "deleteRemoteFile",
+                    path
+                });
+                pathsAdded[path] = true;
+            }
+        }
+        // Remote deletions
+        for (const path in previousRemoteTree.tree) {
+            if (pathsAdded[path]) {
+                continue;
+            }
+            const previousRemoteItem = previousRemoteTree.tree[path];
+            const currentRemoteItem = currentRemoteTree.tree[path];
+            if (!currentRemoteItem && previousRemoteItem) {
+                deltas.push({
+                    type: previousRemoteItem.type === "directory" ? "deleteLocalDirectory" : "deleteLocalFile",
+                    path
+                });
+                pathsAdded[path] = true;
+            }
+        }
+        // Local additions/changes
+        for (const path in currentLocalTree.tree) {
+            if (pathsAdded[path]) {
+                continue;
+            }
+            const currentLocalItem = currentLocalTree.tree[path];
+            const currentRemoteItem = currentRemoteTree.tree[path];
+            if (!currentRemoteItem && currentLocalItem) {
+                deltas.push({
+                    type: currentLocalItem.type === "directory" ? "createRemoteDirectory" : "uploadFile",
+                    path
+                });
+                pathsAdded[path] = true;
+                continue;
+            }
+            if (currentRemoteItem && currentRemoteItem.type === "file") {
+                if (currentLocalItem && currentLocalItem.lastModified > currentRemoteItem.lastModified) {
+                    const itemLocalPath = path_1.default.join(this.sync.syncPair.localPath, currentLocalItem.path);
+                    if ((await this.sync.localFileSystem.createFileHash({ relativePath: path, algorithm: "sha512" })) !==
+                        this.sync.localFileHashes[itemLocalPath]) {
+                        deltas.push({
+                            type: "uploadFile",
+                            path
+                        });
+                        pathsAdded[path] = true;
+                    }
+                }
+            }
+        }
+        // Remote additions/changes
+        for (const path in currentRemoteTree.tree) {
+            if (pathsAdded[path]) {
+                continue;
+            }
+            const currentLocalItem = currentLocalTree.tree[path];
+            const currentRemoteItem = currentRemoteTree.tree[path];
+            if (!currentLocalItem && currentRemoteItem) {
+                deltas.push({
+                    type: currentRemoteItem.type === "directory" ? "createLocalDirectory" : "downloadFile",
+                    path
+                });
+                pathsAdded[path] = true;
+                continue;
+            }
+            if (currentRemoteItem && currentRemoteItem.type === "file") {
+                if (currentLocalItem && currentRemoteItem.lastModified > currentLocalItem.lastModified) {
+                    deltas.push({
+                        type: "downloadFile",
+                        path
+                    });
+                    pathsAdded[path] = true;
+                }
+            }
+        }
+        return deltas;
+    }
+}
+exports.Deltas = Deltas;
+exports.default = Deltas;
+//# sourceMappingURL=deltas.js.map

package/dist/lib/deltas.js.map

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

package/dist/lib/filesystems/local.d.ts

@@ -0,0 +1,160 @@
+/// <reference types="node" />
+import fs from "fs-extra";
+import type Sync from "../sync";
+import type { CloudItem } from "@filen/sdk";
+export type LocalItem = {
+    lastModified: number;
+    type: "file" | "directory";
+    path: string;
+    size: number;
+    creation: number;
+    inode: number;
+};
+export type LocalDirectoryTree = Record<string, LocalItem>;
+export type LocalDirectoryINodes = Record<number, LocalItem>;
+export type LocalTree = {
+    tree: LocalDirectoryTree;
+    inodes: LocalDirectoryINodes;
+};
+/**
+ * LocalFileSystem
+ * @date 3/2/2024 - 12:38:22 PM
+ *
+ * @export
+ * @class LocalFileSystem
+ * @typedef {LocalFileSystem}
+ */
+export declare class LocalFileSystem {
+    private readonly sync;
+    lastDirectoryChangeTimestamp: number;
+    getDirectoryTreeCache: {
+        timestamp: number;
+        tree: LocalDirectoryTree;
+        inodes: LocalDirectoryINodes;
+    };
+    watcherRunning: boolean;
+    private watcherInstance;
+    /**
+     * Creates an instance of LocalFileSystem.
+     * @date 3/2/2024 - 12:38:20 PM
+     *
+     * @constructor
+     * @public
+     * @param {{ sync: Sync }} param0
+     * @param {Sync} param0.sync
+     */
+    constructor({ sync }: {
+        sync: Sync;
+    });
+    /**
+     * Get the local directory tree.
+     * @date 3/2/2024 - 12:38:13 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<LocalTree>}
+     */
+    getDirectoryTree(): Promise<LocalTree>;
+    /**
+     * Start the local sync directory watcher.
+     * @date 3/2/2024 - 12:38:00 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    startDirectoryWatcher(): Promise<void>;
+    /**
+     * Stop the local sync directory watcher.
+     * @date 3/2/2024 - 12:37:48 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    stopDirectoryWatcher(): Promise<void>;
+    /**
+     * Wait for local directory updates to be done.
+     * Sometimes the user might copy a lot of new files, folders etc.
+     * We want to wait (or at least try) until all local operations are done until we start syncing.
+     * This can save a lot of sync cycles.
+     * @date 3/1/2024 - 10:40:14 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    waitForLocalDirectoryChanges(): Promise<void>;
+    /**
+     * Creates a hash of a file using streams.
+     * @date 3/2/2024 - 9:29:48 AM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string; algorithm: "sha512" }} param0
+     * @param {string} param0.relativePath
+     * @param {"sha512"} param0.algorithm
+     * @returns {Promise<string>}
+     */
+    createFileHash({ relativePath, algorithm }: {
+        relativePath: string;
+        algorithm: "sha512";
+    }): Promise<string>;
+    /**
+     * Create a directory inside the local sync path. Recursively creates intermediate directories if needed.
+     * @date 3/2/2024 - 12:36:23 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string }} param0
+     * @param {string} param0.relativePath
+     * @returns {Promise<fs.Stats>}
+     */
+    mkdir({ relativePath }: {
+        relativePath: string;
+    }): Promise<fs.Stats>;
+    /**
+     * Delete a file/directory inside the local sync path.
+     * @date 3/3/2024 - 10:05:55 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string; permanent?: boolean }} param0
+     * @param {string} param0.relativePath
+     * @param {boolean} [param0.permanent=false]
+     * @returns {Promise<void>}
+     */
+    unlink({ relativePath, permanent }: {
+        relativePath: string;
+        permanent?: boolean;
+    }): Promise<void>;
+    /**
+     * Rename a file/directory inside the local sync path. Recursively creates intermediate directories if needed.
+     * @date 3/2/2024 - 12:41:15 PM
+     *
+     * @public
+     * @async
+     * @param {{ fromRelativePath: string; toRelativePath: string }} param0
+     * @param {string} param0.fromRelativePath
+     * @param {string} param0.toRelativePath
+     * @returns {Promise<fs.Stats>}
+     */
+    rename({ fromRelativePath, toRelativePath }: {
+        fromRelativePath: string;
+        toRelativePath: string;
+    }): Promise<fs.Stats>;
+    /**
+     * Upload a local file.
+     * @date 3/2/2024 - 9:43:58 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string }} param0
+     * @param {string} param0.relativePath
+     * @returns {Promise<void>}
+     */
+    upload({ relativePath }: {
+        relativePath: string;
+    }): Promise<CloudItem>;
+}
+export default LocalFileSystem;