@filen/sync 0.1.1

package/dist/lib/filesystems/local.js

@@ -0,0 +1,273 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalFileSystem = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const watcher_1 = __importDefault(require("@parcel/watcher"));
+const utils_1 = require("../../utils");
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
+const constants_1 = require("../../constants");
+const crypto_1 = __importDefault(require("crypto"));
+const stream_1 = require("stream");
+const util_1 = require("util");
+const pipelineAsync = (0, util_1.promisify)(stream_1.pipeline);
+/**
+ * LocalFileSystem
+ * @date 3/2/2024 - 12:38:22 PM
+ *
+ * @export
+ * @class LocalFileSystem
+ * @typedef {LocalFileSystem}
+ */
+class LocalFileSystem {
+    /**
+     * 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 }) {
+        this.lastDirectoryChangeTimestamp = Date.now() - constants_1.SYNC_INTERVAL * 2;
+        this.getDirectoryTreeCache = {
+            timestamp: 0,
+            tree: {},
+            inodes: {}
+        };
+        this.watcherRunning = false;
+        this.watcherInstance = null;
+        this.sync = sync;
+    }
+    /**
+     * Get the local directory tree.
+     * @date 3/2/2024 - 12:38:13 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<LocalTree>}
+     */
+    async getDirectoryTree() {
+        if (this.lastDirectoryChangeTimestamp > 0 &&
+            this.getDirectoryTreeCache.timestamp > 0 &&
+            this.lastDirectoryChangeTimestamp < this.getDirectoryTreeCache.timestamp) {
+            return {
+                tree: this.getDirectoryTreeCache.tree,
+                inodes: this.getDirectoryTreeCache.inodes
+            };
+        }
+        const tree = {};
+        const inodes = {};
+        const dir = await fs_extra_1.default.readdir(this.sync.syncPair.localPath, {
+            recursive: true,
+            encoding: "utf-8"
+        });
+        const promises = [];
+        for (const entry of dir) {
+            promises.push(new Promise((resolve, reject) => {
+                if (entry.startsWith(".filen.trash.local")) {
+                    resolve();
+                    return;
+                }
+                const itemPath = path_1.default.join(this.sync.syncPair.localPath, entry);
+                const entryPath = `/${process_1.default.platform === "win32" ? entry.replace(/\\/g, "/") : entry}`;
+                fs_extra_1.default.stat(itemPath)
+                    .then(stats => {
+                    const item = {
+                        lastModified: parseInt(stats.mtimeMs), // Sometimes comes as a float, but we need an int
+                        type: stats.isDirectory() ? "directory" : "file",
+                        path: entryPath,
+                        creation: parseInt(stats.birthtimeMs), // Sometimes comes as a float, but we need an int
+                        size: stats.size,
+                        inode: stats.ino
+                    };
+                    tree[entryPath] = item;
+                    inodes[stats.ino] = item;
+                    resolve();
+                })
+                    .catch(reject);
+            }));
+        }
+        await (0, utils_1.promiseAllChunked)(promises);
+        this.getDirectoryTreeCache = {
+            timestamp: Date.now(),
+            tree,
+            inodes
+        };
+        return { tree, inodes };
+    }
+    /**
+     * Start the local sync directory watcher.
+     * @date 3/2/2024 - 12:38:00 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    async startDirectoryWatcher() {
+        if (this.watcherInstance) {
+            return;
+        }
+        this.watcherInstance = await watcher_1.default.subscribe(this.sync.syncPair.localPath, (err, events) => {
+            if (!err && events) {
+                this.lastDirectoryChangeTimestamp = Date.now();
+            }
+        });
+    }
+    /**
+     * Stop the local sync directory watcher.
+     * @date 3/2/2024 - 12:37:48 PM
+     *
+     * @public
+     * @async
+     * @returns {Promise<void>}
+     */
+    async stopDirectoryWatcher() {
+        if (!this.watcherInstance) {
+            return;
+        }
+        await this.watcherInstance.unsubscribe();
+        this.watcherInstance = null;
+    }
+    /**
+     * 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>}
+     */
+    async waitForLocalDirectoryChanges() {
+        await new Promise(resolve => {
+            if (Date.now() > this.lastDirectoryChangeTimestamp + constants_1.SYNC_INTERVAL) {
+                resolve();
+                return;
+            }
+            const wait = setInterval(() => {
+                if (Date.now() > this.lastDirectoryChangeTimestamp + constants_1.SYNC_INTERVAL) {
+                    clearInterval(wait);
+                    resolve();
+                }
+            }, 100);
+        });
+    }
+    /**
+     * 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>}
+     */
+    async createFileHash({ relativePath, algorithm }) {
+        const localPath = path_1.default.join(this.sync.syncPair.localPath, relativePath);
+        const hasher = crypto_1.default.createHash(algorithm);
+        await pipelineAsync(fs_extra_1.default.createReadStream(localPath), hasher);
+        const hash = hasher.digest("hex");
+        return hash;
+    }
+    /**
+     * 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>}
+     */
+    async mkdir({ relativePath }) {
+        const localPath = path_1.default.join(this.sync.syncPair.localPath, relativePath);
+        await fs_extra_1.default.ensureDir(localPath);
+        return await fs_extra_1.default.stat(localPath);
+    }
+    /**
+     * 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>}
+     */
+    async unlink({ relativePath, permanent = false }) {
+        const localPath = path_1.default.join(this.sync.syncPair.localPath, relativePath);
+        if (!permanent) {
+            const localTrashPath = path_1.default.join(this.sync.syncPair.localPath, ".filen.trash.local");
+            await fs_extra_1.default.ensureDir(localTrashPath);
+            await fs_extra_1.default.move(localPath, path_1.default.join(localTrashPath, path_1.default.posix.basename(relativePath)), {
+                overwrite: true
+            });
+            return;
+        }
+        await fs_extra_1.default.rm(localPath, {
+            force: true,
+            maxRetries: 60 * 10,
+            recursive: true,
+            retryDelay: 100
+        });
+    }
+    /**
+     * 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>}
+     */
+    async rename({ fromRelativePath, toRelativePath }) {
+        const fromLocalPath = path_1.default.join(this.sync.syncPair.localPath, fromRelativePath);
+        const toLocalPath = path_1.default.join(this.sync.syncPair.localPath, toRelativePath);
+        const fromLocalPathParentPath = path_1.default.dirname(fromLocalPath);
+        const toLocalPathParentPath = path_1.default.dirname(toLocalPath);
+        await fs_extra_1.default.ensureDir(toLocalPathParentPath);
+        if (fromLocalPathParentPath === toLocalPathParentPath) {
+            await fs_extra_1.default.rename(fromLocalPath, toLocalPath);
+            return await fs_extra_1.default.stat(toLocalPath);
+        }
+        await fs_extra_1.default.move(fromLocalPath, toLocalPath, {
+            overwrite: true
+        });
+        return await fs_extra_1.default.stat(toLocalPath);
+    }
+    /**
+     * 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>}
+     */
+    async upload({ relativePath }) {
+        const localPath = path_1.default.join(this.sync.syncPair.localPath, relativePath);
+        const parentPath = path_1.default.posix.dirname(relativePath);
+        await this.sync.remoteFileSystem.mkdir({ relativePath: parentPath });
+        const parentUUID = await this.sync.remoteFileSystem.pathToItemUUID({ relativePath: parentPath });
+        if (!parentUUID) {
+            throw new Error(`Could not upload ${relativePath}: Parent path not found.`);
+        }
+        const hash = await this.createFileHash({ relativePath, algorithm: "sha512" });
+        this.sync.localFileHashes[relativePath] = hash;
+        return await this.sync.sdk.cloud().uploadLocalFile({ source: localPath, parent: parentUUID });
+    }
+}
+exports.LocalFileSystem = LocalFileSystem;
+exports.default = LocalFileSystem;
+//# sourceMappingURL=local.js.map

package/dist/lib/filesystems/local.js.map

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

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

@@ -0,0 +1,102 @@
+/// <reference types="node" />
+import type Sync from "../sync";
+import type { CloudItemTree, FSItemType } from "@filen/sdk";
+import fs from "fs-extra";
+import type { DistributiveOmit, Prettify } from "../../types";
+export type RemoteItem = Prettify<DistributiveOmit<CloudItemTree, "parent"> & {
+    path: string;
+}>;
+export type RemoteDirectoryTree = Record<string, RemoteItem>;
+export type RemoteDirectoryUUIDs = Record<string, RemoteItem>;
+export type RemoteTree = {
+    tree: RemoteDirectoryTree;
+    uuids: RemoteDirectoryUUIDs;
+};
+export declare class RemoteFileSystem {
+    private readonly sync;
+    getDirectoryTreeCache: {
+        timestamp: number;
+        tree: RemoteDirectoryTree;
+        uuids: RemoteDirectoryUUIDs;
+    };
+    private readonly mutex;
+    private readonly mkdirMutex;
+    constructor({ sync }: {
+        sync: Sync;
+    });
+    getDirectoryTree(): Promise<RemoteTree>;
+    /**
+     * Find the corresponding UUID of the relative path.
+     * @date 3/3/2024 - 6:55:53 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string; type?: FSItemType }} param0
+     * @param {string} param0.relativePath
+     * @param {FSItemType} param0.type
+     * @returns {Promise<string | null>}
+     */
+    pathToItemUUID({ relativePath, type }: {
+        relativePath: string;
+        type?: FSItemType;
+    }): Promise<string | null>;
+    /**
+     * Create a directory inside the remote sync path. Recursively creates intermediate directories if needed.
+     * @date 3/2/2024 - 9:34:14 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string }} param0
+     * @param {string} param0.relativePath
+     * @returns {Promise<string>}
+     */
+    mkdir({ relativePath }: {
+        relativePath: string;
+    }): Promise<string>;
+    /**
+     * Delete a file/directory inside the remote sync path.
+     * @date 3/3/2024 - 7:03:18 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string; type?: FSItemType; permanent?: boolean }} param0
+     * @param {string} param0.relativePath
+     * @param {FSItemType} param0.type
+     * @param {boolean} [param0.permanent=false]
+     * @returns {Promise<void>}
+     */
+    unlink({ relativePath, type, permanent }: {
+        relativePath: string;
+        type?: FSItemType;
+        permanent?: boolean;
+    }): Promise<void>;
+    /**
+     * Rename a file/directory inside the remote sync path. Recursively creates intermediate directories if needed.
+     * @date 3/2/2024 - 9:35:12 PM
+     *
+     * @public
+     * @async
+     * @param {{ fromRelativePath: string; toRelativePath: string }} param0
+     * @param {string} param0.fromRelativePath
+     * @param {string} param0.toRelativePath
+     * @returns {Promise<void>}
+     */
+    rename({ fromRelativePath, toRelativePath }: {
+        fromRelativePath: string;
+        toRelativePath: string;
+    }): Promise<void>;
+    /**
+     * Download a remote file.
+     * @date 3/2/2024 - 9:41:59 PM
+     *
+     * @public
+     * @async
+     * @param {{ relativePath: string }} param0
+     * @param {string} param0.relativePath
+     * @returns {Promise<fs.Stats>}
+     */
+    download({ relativePath }: {
+        relativePath: string;
+    }): Promise<fs.Stats>;
+}
+export default RemoteFileSystem;