@sync-in/server 1.8.1 → 1.9.0

package/server/applications/files/services/files-content-manager.service.js

@@ -131,7 +131,7 @@ let FilesContentManager = class FilesContentManager {
                 }
             }
         } catch (e) {
-            this.logger.warn(`${this.parseFiles.name} - ${context.indexSuffix} - unable to parse : ${dir} : ${e}`);
+            this.logger.warn(`${this.parseFiles.name} - ${context.indexSuffix} - unable to parse: ${dir} - ${e}`);
         }
     }
     async analyzeFile(realPath, context, isRootFile = false) {
@@ -144,7 +144,7 @@ let FilesContentManager = class FilesContentManager {
         try {
             stats = await _promises.default.stat(realPath);
         } catch (e) {
-            this.logger.warn(`${this.analyzeFile.name} - unable to stats ${realPath} : ${e}`);
+            this.logger.warn(`${this.analyzeFile.name} - unable to stats: ${realPath} - ${e}`);
             return null;
         }
         if (stats.size === 0 || stats.size > this.maxDocumentSize) {
@@ -181,7 +181,7 @@ let FilesContentManager = class FilesContentManager {
             });
             return content.length ? content : null;
         } catch (e) {
-            this.logger.warn(`${this.parseContent.name} - unable to index : ${rPath} : ${e}`);
+            this.logger.warn(`${this.parseContent.name} - unable to index: ${rPath} - ${e}`);
         }
         return null;
     }

package/server/applications/files/services/files-content-manager.service.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../backend/src/applications/files/services/files-content-manager.service.ts"],"sourcesContent":["/*\n * Copyright (C) 2012-2025 Johan Legrand <johan.legrand@sync-in.com>\n * This file is part of Sync-in | The open source file sync and share solution\n * See the LICENSE file for licensing details\n */\n\nimport { Injectable, Logger } from '@nestjs/common'\nimport fs from 'fs/promises'\nimport { Stats } from 'node:fs'\nimport path from 'node:path'\nimport { indexableExtensions, shareIndexPrefix, spaceIndexPrefix, userIndexPrefix } from '../constants/indexing'\nimport { FileIndexContext, FileParseContext } from '../interfaces/file-parse-index'\nimport { FilesIndexer } from '../models/files-indexer'\nimport { FileContent } from '../schemas/file-content.interface'\nimport { docTextify } from '../utils/doc-textify/doc-textify'\nimport { getMimeType } from '../utils/files'\nimport { FilesParser } from './files-parser.service'\n\n@Injectable()\nexport class FilesContentManager {\n  private readonly maxDocumentSize = 150 * 1_000_000\n  private readonly logger = new Logger(FilesContentManager.name)\n\n  constructor(\n    private readonly filesIndexer: FilesIndexer,\n    private readonly filesParser: FilesParser\n  ) {}\n\n  async parseAndIndexAllFiles(): Promise<void> {\n    const indexSuffixes: string[] = []\n    for await (const [id, type, paths] of this.filesParser.allPaths()) {\n      let indexSuffix: string\n      switch (type) {\n        case 'user':\n          indexSuffix = `${userIndexPrefix}${id}`\n          break\n        case 'space':\n          indexSuffix = `${spaceIndexPrefix}${id}`\n          break\n        case 'share':\n          indexSuffix = `${shareIndexPrefix}${id}`\n      }\n      try {\n        await this.indexFiles(indexSuffix, paths)\n      } catch (e) {\n        this.logger.error(`${this.parseAndIndexAllFiles.name} : ${e}`)\n      }\n      indexSuffixes.push(indexSuffix)\n    }\n    // clean up old tables\n    await this.filesIndexer.cleanIndexes(indexSuffixes)\n  }\n\n  private async indexFiles(indexSuffix: string, paths: FileParseContext[]): Promise<void> {\n    const indexName = this.filesIndexer.getIndexName(indexSuffix)\n    if (!(await this.filesIndexer.createIndex(indexName))) {\n      return\n    }\n    const context: FileIndexContext = {\n      indexSuffix: indexSuffix,\n      pathPrefix: '',\n      regexBasePath: undefined,\n      db: await this.filesIndexer.getRecordStats(indexName),\n      fs: new Set()\n    }\n    let indexedRecords = 0\n    let errorRecords = 0\n\n    for (const p of paths) {\n      context.regexBasePath = new RegExp(`^/?${p.realPath}/?`)\n      context.pathPrefix = p.pathPrefix || ''\n      if (!p.isDir) {\n        // Handles the space root file or shared file case\n        const rootFileContent = await this.analyzeFile(p.realPath, context, true)\n        if (rootFileContent !== null) {\n          this.filesIndexer.insertRecord(indexName, rootFileContent).catch((e: Error) => {\n            errorRecords++\n            this.logger.error(`${this.indexFiles.name} - ${indexSuffix} | ${rootFileContent.name} : ${e}`)\n          })\n          indexedRecords++\n        }\n        continue\n      }\n      for await (const fileContent of this.parseFiles(p.realPath, context)) {\n        this.filesIndexer.insertRecord(indexName, fileContent).catch((e: Error) => {\n          errorRecords++\n          this.logger.error(`${this.indexFiles.name} - ${indexSuffix} | ${fileContent.name} : ${e}`)\n        })\n        indexedRecords++\n      }\n    }\n\n    if (context.db.size === 0 && indexedRecords === 0) {\n      // case when no data\n      this.filesIndexer\n        .dropIndex(indexName)\n        .catch((e: Error) => this.logger.error(`${this.indexFiles.name} - ${indexSuffix} - unable to drop index : ${e}`))\n      this.logger.log(`${this.indexFiles.name} - ${indexSuffix} - no data, index not stored`)\n    } else {\n      // clean up old records\n      const recordsToDelete: number[] = [...context.db.keys()].filter((key) => !context.fs.has(key))\n      if (recordsToDelete.length > 0) {\n        this.filesIndexer\n          .deleteRecords(indexName, recordsToDelete)\n          .catch((e: Error) => this.logger.error(`${this.indexFiles.name} - ${indexSuffix} - unable to delete records : ${e}`))\n      }\n      if (indexedRecords === 0 && errorRecords === 0 && recordsToDelete.length === 0) {\n        this.logger.log(`${this.indexFiles.name} - ${indexSuffix} - no new data`)\n      } else {\n        this.logger.log(\n          `${this.indexFiles.name} - ${indexSuffix} - indexed: ${indexedRecords - errorRecords}, errors: ${errorRecords}, deleted: ${recordsToDelete.length}`\n        )\n      }\n    }\n  }\n\n  private async *parseFiles(dir: string, context: FileIndexContext): AsyncGenerator<FileContent> {\n    try {\n      for (const entry of await fs.readdir(dir, { withFileTypes: true })) {\n        const realPath = path.join(entry.parentPath, entry.name)\n        if (entry.isDirectory()) {\n          yield* this.parseFiles(realPath, context)\n          continue\n        }\n        const fileContent = await this.analyzeFile(realPath, context)\n        if (fileContent !== null) {\n          yield fileContent\n        }\n      }\n    } catch (e) {\n      this.logger.warn(`${this.parseFiles.name} - ${context.indexSuffix} - unable to parse : ${dir} : ${e}`)\n    }\n  }\n\n  private async analyzeFile(realPath: string, context: FileIndexContext, isRootFile = false): Promise<FileContent> {\n    const extension = path.extname(realPath).slice(1).toLowerCase()\n    if (!indexableExtensions.has(extension)) return null\n\n    const fileName = isRootFile ? path.basename(context.pathPrefix) : path.basename(realPath)\n\n    // ignore temporary documents\n    if (fileName.startsWith('~$')) return null\n\n    let stats: Stats\n    try {\n      stats = await fs.stat(realPath)\n    } catch (e) {\n      this.logger.warn(`${this.analyzeFile.name} - unable to stats ${realPath} : ${e}`)\n      return null\n    }\n    if (stats.size === 0 || stats.size > this.maxDocumentSize) {\n      return null\n    }\n\n    const filePath = isRootFile\n      ? path.dirname(context.pathPrefix) || '.'\n      : path.join(context.pathPrefix, path.dirname(realPath).replace(context.regexBasePath, '') || '.')\n\n    const f = context.db.get(stats.ino)\n    if (f && f.size === stats.size && f.path === filePath && f.name === fileName) {\n      // no changes, store inode id & skip it\n      context.fs.add(stats.ino)\n      return null\n    }\n\n    // store inode id\n    context.fs.add(stats.ino)\n\n    // store the content with null value to not parse it later\n    return {\n      id: stats.ino,\n      path: filePath,\n      name: fileName,\n      mime: getMimeType(realPath, false),\n      size: stats.size,\n      mtime: stats.mtime.getTime(),\n      content: await this.parseContent(realPath, extension)\n    }\n  }\n\n  private async parseContent(rPath: string, extension: string): Promise<string> {\n    try {\n      const content = await docTextify(\n        rPath,\n        { newlineDelimiter: ' ', minCharsToExtract: 10 },\n        {\n          extension: extension,\n          verified: true\n        }\n      )\n      return content.length ? content : null\n    } catch (e) {\n      this.logger.warn(`${this.parseContent.name} - unable to index : ${rPath} : ${e}`)\n    }\n    return null\n  }\n}\n"],"names":["FilesContentManager","parseAndIndexAllFiles","indexSuffixes","id","type","paths","filesParser","allPaths","indexSuffix","userIndexPrefix","spaceIndexPrefix","shareIndexPrefix","indexFiles","e","logger","error","name","push","filesIndexer","cleanIndexes","indexName","getIndexName","createIndex","context","pathPrefix","regexBasePath","undefined","db","getRecordStats","fs","Set","indexedRecords","errorRecords","p","RegExp","realPath","isDir","rootFileContent","analyzeFile","insertRecord","catch","fileContent","parseFiles","size","dropIndex","log","recordsToDelete","keys","filter","key","has","length","deleteRecords","dir","entry","readdir","withFileTypes","path","join","parentPath","isDirectory","warn","isRootFile","extension","extname","slice","toLowerCase","indexableExtensions","fileName","basename","startsWith","stats","stat","maxDocumentSize","filePath","dirname","replace","f","get","ino","add","mime","getMimeType","mtime","getTime","content","parseContent","rPath","docTextify","newlineDelimiter","minCharsToExtract","verified","Logger"],"mappings":"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"}
+{"version":3,"sources":["../../../../../backend/src/applications/files/services/files-content-manager.service.ts"],"sourcesContent":["/*\n * Copyright (C) 2012-2025 Johan Legrand <johan.legrand@sync-in.com>\n * This file is part of Sync-in | The open source file sync and share solution\n * See the LICENSE file for licensing details\n */\n\nimport { Injectable, Logger } from '@nestjs/common'\nimport fs from 'fs/promises'\nimport { Stats } from 'node:fs'\nimport path from 'node:path'\nimport { indexableExtensions, shareIndexPrefix, spaceIndexPrefix, userIndexPrefix } from '../constants/indexing'\nimport { FileIndexContext, FileParseContext } from '../interfaces/file-parse-index'\nimport { FilesIndexer } from '../models/files-indexer'\nimport { FileContent } from '../schemas/file-content.interface'\nimport { docTextify } from '../utils/doc-textify/doc-textify'\nimport { getMimeType } from '../utils/files'\nimport { FilesParser } from './files-parser.service'\n\n@Injectable()\nexport class FilesContentManager {\n  private readonly maxDocumentSize = 150 * 1_000_000\n  private readonly logger = new Logger(FilesContentManager.name)\n\n  constructor(\n    private readonly filesIndexer: FilesIndexer,\n    private readonly filesParser: FilesParser\n  ) {}\n\n  async parseAndIndexAllFiles(): Promise<void> {\n    const indexSuffixes: string[] = []\n    for await (const [id, type, paths] of this.filesParser.allPaths()) {\n      let indexSuffix: string\n      switch (type) {\n        case 'user':\n          indexSuffix = `${userIndexPrefix}${id}`\n          break\n        case 'space':\n          indexSuffix = `${spaceIndexPrefix}${id}`\n          break\n        case 'share':\n          indexSuffix = `${shareIndexPrefix}${id}`\n      }\n      try {\n        await this.indexFiles(indexSuffix, paths)\n      } catch (e) {\n        this.logger.error(`${this.parseAndIndexAllFiles.name} : ${e}`)\n      }\n      indexSuffixes.push(indexSuffix)\n    }\n    // clean up old tables\n    await this.filesIndexer.cleanIndexes(indexSuffixes)\n  }\n\n  private async indexFiles(indexSuffix: string, paths: FileParseContext[]): Promise<void> {\n    const indexName = this.filesIndexer.getIndexName(indexSuffix)\n    if (!(await this.filesIndexer.createIndex(indexName))) {\n      return\n    }\n    const context: FileIndexContext = {\n      indexSuffix: indexSuffix,\n      pathPrefix: '',\n      regexBasePath: undefined,\n      db: await this.filesIndexer.getRecordStats(indexName),\n      fs: new Set()\n    }\n    let indexedRecords = 0\n    let errorRecords = 0\n\n    for (const p of paths) {\n      context.regexBasePath = new RegExp(`^/?${p.realPath}/?`)\n      context.pathPrefix = p.pathPrefix || ''\n      if (!p.isDir) {\n        // Handles the space root file or shared file case\n        const rootFileContent = await this.analyzeFile(p.realPath, context, true)\n        if (rootFileContent !== null) {\n          this.filesIndexer.insertRecord(indexName, rootFileContent).catch((e: Error) => {\n            errorRecords++\n            this.logger.error(`${this.indexFiles.name} - ${indexSuffix} | ${rootFileContent.name} : ${e}`)\n          })\n          indexedRecords++\n        }\n        continue\n      }\n      for await (const fileContent of this.parseFiles(p.realPath, context)) {\n        this.filesIndexer.insertRecord(indexName, fileContent).catch((e: Error) => {\n          errorRecords++\n          this.logger.error(`${this.indexFiles.name} - ${indexSuffix} | ${fileContent.name} : ${e}`)\n        })\n        indexedRecords++\n      }\n    }\n\n    if (context.db.size === 0 && indexedRecords === 0) {\n      // case when no data\n      this.filesIndexer\n        .dropIndex(indexName)\n        .catch((e: Error) => this.logger.error(`${this.indexFiles.name} - ${indexSuffix} - unable to drop index : ${e}`))\n      this.logger.log(`${this.indexFiles.name} - ${indexSuffix} - no data, index not stored`)\n    } else {\n      // clean up old records\n      const recordsToDelete: number[] = [...context.db.keys()].filter((key) => !context.fs.has(key))\n      if (recordsToDelete.length > 0) {\n        this.filesIndexer\n          .deleteRecords(indexName, recordsToDelete)\n          .catch((e: Error) => this.logger.error(`${this.indexFiles.name} - ${indexSuffix} - unable to delete records : ${e}`))\n      }\n      if (indexedRecords === 0 && errorRecords === 0 && recordsToDelete.length === 0) {\n        this.logger.log(`${this.indexFiles.name} - ${indexSuffix} - no new data`)\n      } else {\n        this.logger.log(\n          `${this.indexFiles.name} - ${indexSuffix} - indexed: ${indexedRecords - errorRecords}, errors: ${errorRecords}, deleted: ${recordsToDelete.length}`\n        )\n      }\n    }\n  }\n\n  private async *parseFiles(dir: string, context: FileIndexContext): AsyncGenerator<FileContent> {\n    try {\n      for (const entry of await fs.readdir(dir, { withFileTypes: true })) {\n        const realPath = path.join(entry.parentPath, entry.name)\n        if (entry.isDirectory()) {\n          yield* this.parseFiles(realPath, context)\n          continue\n        }\n        const fileContent = await this.analyzeFile(realPath, context)\n        if (fileContent !== null) {\n          yield fileContent\n        }\n      }\n    } catch (e) {\n      this.logger.warn(`${this.parseFiles.name} - ${context.indexSuffix} - unable to parse: ${dir} - ${e}`)\n    }\n  }\n\n  private async analyzeFile(realPath: string, context: FileIndexContext, isRootFile = false): Promise<FileContent> {\n    const extension = path.extname(realPath).slice(1).toLowerCase()\n    if (!indexableExtensions.has(extension)) return null\n\n    const fileName = isRootFile ? path.basename(context.pathPrefix) : path.basename(realPath)\n\n    // ignore temporary documents\n    if (fileName.startsWith('~$')) return null\n\n    let stats: Stats\n    try {\n      stats = await fs.stat(realPath)\n    } catch (e) {\n      this.logger.warn(`${this.analyzeFile.name} - unable to stats: ${realPath} - ${e}`)\n      return null\n    }\n    if (stats.size === 0 || stats.size > this.maxDocumentSize) {\n      return null\n    }\n\n    const filePath = isRootFile\n      ? path.dirname(context.pathPrefix) || '.'\n      : path.join(context.pathPrefix, path.dirname(realPath).replace(context.regexBasePath, '') || '.')\n\n    const f = context.db.get(stats.ino)\n    if (f && f.size === stats.size && f.path === filePath && f.name === fileName) {\n      // no changes, store inode id & skip it\n      context.fs.add(stats.ino)\n      return null\n    }\n\n    // store inode id\n    context.fs.add(stats.ino)\n\n    // store the content with null value to not parse it later\n    return {\n      id: stats.ino,\n      path: filePath,\n      name: fileName,\n      mime: getMimeType(realPath, false),\n      size: stats.size,\n      mtime: stats.mtime.getTime(),\n      content: await this.parseContent(realPath, extension)\n    }\n  }\n\n  private async parseContent(rPath: string, extension: string): Promise<string> {\n    try {\n      const content = await docTextify(\n        rPath,\n        { newlineDelimiter: ' ', minCharsToExtract: 10 },\n        {\n          extension: extension,\n          verified: true\n        }\n      )\n      return content.length ? content : null\n    } catch (e) {\n      this.logger.warn(`${this.parseContent.name} - unable to index: ${rPath} - ${e}`)\n    }\n    return null\n  }\n}\n"],"names":["FilesContentManager","parseAndIndexAllFiles","indexSuffixes","id","type","paths","filesParser","allPaths","indexSuffix","userIndexPrefix","spaceIndexPrefix","shareIndexPrefix","indexFiles","e","logger","error","name","push","filesIndexer","cleanIndexes","indexName","getIndexName","createIndex","context","pathPrefix","regexBasePath","undefined","db","getRecordStats","fs","Set","indexedRecords","errorRecords","p","RegExp","realPath","isDir","rootFileContent","analyzeFile","insertRecord","catch","fileContent","parseFiles","size","dropIndex","log","recordsToDelete","keys","filter","key","has","length","deleteRecords","dir","entry","readdir","withFileTypes","path","join","parentPath","isDirectory","warn","isRootFile","extension","extname","slice","toLowerCase","indexableExtensions","fileName","basename","startsWith","stats","stat","maxDocumentSize","filePath","dirname","replace","f","get","ino","add","mime","getMimeType","mtime","getTime","content","parseContent","rPath","docTextify","newlineDelimiter","minCharsToExtract","verified","Logger"],"mappings":"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"}

package/server/applications/files/services/files-lock-manager.service.js

@@ -36,7 +36,7 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 let FilesLockManager = class FilesLockManager {
-    async create(user, dbFile, depth, ttl, davLock) {
+    async create(user, dbFile, depth, davLock, ttl) {
         let token;
         let lockscope;
         if (davLock) {
@@ -62,7 +62,7 @@ let FilesLockManager = class FilesLockManager {
             }
             throw new Error(e);
         }
-        ttl ??= FilesLockManager.defaultLockTimeoutSeconds;
+        ttl ??= _cache.CACHE_LOCK_DEFAULT_TTL;
         const key = `${_cache.CACHE_LOCK_PREFIX}|${this.genSuffixKey(dbFile, {
             depth: depth,
             token: token
@@ -83,6 +83,38 @@ let FilesLockManager = class FilesLockManager {
             lock
         ];
     }
+    async createOrRefresh(user, dbFile, depth, ttl) {
+        // Returns: [created, lock]
+        ttl ??= _cache.CACHE_LOCK_DEFAULT_TTL;
+        const locks = await this.getLocksByPath(dbFile);
+        // Check the existing lock and refresh it if needed
+        if (locks.length > 0) {
+            for (const lock of locks){
+                if (lock.owner.id === user.id) {
+                    // Refresh if more than half of the TTL has passed
+                    const mustRefresh = lock.expiration - (0, _shared.currentTimeStamp)() < ttl / 2;
+                    if (mustRefresh) {
+                        this.refreshLockTimeout(lock, ttl).catch((e)=>this.logger.error(`${this.createOrRefresh.name} - ${e}`));
+                    }
+                } else {
+                    throw new _filelockerror.LockConflict(lock, 'Conflicting lock');
+                }
+            }
+            return [
+                false,
+                locks[0]
+            ];
+        }
+        // Create the lock
+        const [ok, lock] = await this.create(user, dbFile, depth, null, ttl);
+        if (!ok) {
+            throw new _filelockerror.LockConflict(lock, 'Conflicting lock');
+        }
+        return [
+            true,
+            lock
+        ];
+    }
     removeLock(key) {
         this.logger.verbose(`${this.removeLock.name} - ${key}`);
         return this.cache.del(key);
@@ -159,7 +191,7 @@ let FilesLockManager = class FilesLockManager {
     }
     async checkConflicts(dbFile, depth, options) {
         /* Checks if a file could be modified, created, moved, or deleted
-       Throws an `LockConflict` error when there are parent locks (depth: 0) or child locks (depth: infinite) that prevent modifications
+       Throws an `LockConflict` error when there are parent locks (depth: 0) or child locks (depth: infinite) that prevent modification
        Returns on the first conflict (compliant with the RFC 4918)
     */ for await (const l of this.searchParentLocks(dbFile, {
             includeRoot: true,
@@ -186,6 +218,28 @@ let FilesLockManager = class FilesLockManager {
             }
         }
     }
+    async *searchChildLocks(dbFile) {
+        const props = this.genSuffixKey(dbFile, {
+            ignorePath: true
+        });
+        const path = dbFile.path === '.' ? '*' : `${dbFile.path}/*`;
+        this.logger.verbose(`${this.searchChildLocks.name} - ${path} (${props})`);
+        const keys = await this.searchKeysByPath(path, props);
+        if (keys.length) {
+            for (const l of (await this.cache.mget(keys)).filter(Boolean)){
+                this.logger.verbose(`-> ${l.dbFilePath} (owner: ${l.owner.login})`);
+                yield l;
+            }
+        }
+    }
+    convertLockToFileLockProps(lock) {
+        if (!lock) return null;
+        return {
+            owner: lock?.davLock?.owner || `${lock.owner.fullName} (${lock.owner.email})`,
+            ownerLogin: lock.owner.login,
+            isExclusive: lock?.davLock?.lockscope ? lock?.davLock?.lockscope === _webdav.LOCK_SCOPE.EXCLUSIVE : true
+        };
+    }
     async *searchParentLocks(dbFile, options = {}) {
         const props = this.genSuffixKey(dbFile, {
             ignorePath: true
@@ -209,20 +263,6 @@ let FilesLockManager = class FilesLockManager {
             path = (0, _files.dirName)(path);
         }
     }
-    async *searchChildLocks(dbFile) {
-        const props = this.genSuffixKey(dbFile, {
-            ignorePath: true
-        });
-        const path = dbFile.path === '.' ? '*' : `${dbFile.path}/*`;
-        this.logger.verbose(`${this.searchChildLocks.name} - ${path} (${props})`);
-        const keys = await this.searchKeysByPath(path, props);
-        if (keys.length) {
-            for (const l of (await this.cache.mget(keys)).filter(Boolean)){
-                this.logger.verbose(`-> ${l.dbFilePath} (owner: ${l.owner.login})`);
-                yield l;
-            }
-        }
-    }
     async searchKeyByToken(token) {
         const keys = await this.cache.keys(`${_cache.CACHE_LOCK_PREFIX}|token:${token}|*`);
         if (!keys.length) {
@@ -258,10 +298,7 @@ let FilesLockManager = class FilesLockManager {
     }
     constructor(cache){
         this.cache = cache;
-        this.logger = new _common.Logger(FilesLockManager.name);
-    }
-};
-/* Philosophy
+        /* Philosophy
   Currently this manager only handle conflicting locks between multiple users, not between clients
   - The locks created from api
       * They do not contain a token key or a davLock property
@@ -273,7 +310,9 @@ let FilesLockManager = class FilesLockManager {
       * If created with WebDAV, they are stored with a token and a davLock property
       * If created with OnlyOffice, they are stored with no token and a davLock property whose `locktoken` & `lockroot` properties are null
   Cache token key format = `flock|token?:${uuid}|path:${path}|ownerId?:${number}|spaceId?:${number}|...props` => FileLock
-  */ FilesLockManager.defaultLockTimeoutSeconds = 86400; // 1 day
+  */ this.logger = new _common.Logger(FilesLockManager.name);
+    }
+};
 FilesLockManager = _ts_decorate([
     (0, _common.Injectable)(),
     _ts_metadata("design:type", Function),

package/server/applications/files/services/files-lock-manager.service.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../backend/src/applications/files/services/files-lock-manager.service.ts"],"sourcesContent":["/*\n * Copyright (C) 2012-2025 Johan Legrand <johan.legrand@sync-in.com>\n * This file is part of Sync-in | The open source file sync and share solution\n * See the LICENSE file for licensing details\n */\n\nimport { Injectable, Logger } from '@nestjs/common'\nimport crypto from 'node:crypto'\n\nimport { currentTimeStamp } from '../../../common/shared'\nimport { Cache } from '../../../infrastructure/cache/services/cache.service'\nimport { UserModel } from '../../users/models/user.model'\nimport { DEPTH, LOCK_DEPTH, LOCK_PREFIX, LOCK_SCOPE } from '../../webdav/constants/webdav'\nimport { WebDAVLock } from '../../webdav/interfaces/webdav.interface'\nimport { CACHE_LOCK_PREFIX } from '../constants/cache'\nimport { FileDBProps } from '../interfaces/file-db-props.interface'\nimport { FileLock } from '../interfaces/file-lock.interface'\nimport { LockConflict } from '../models/file-lock-error'\nimport { files } from '../schemas/files.schema'\nimport { dirName, fileName } from '../utils/files'\n\n@Injectable()\nexport class FilesLockManager {\n  /* Philosophy\n  Currently this manager only handle conflicting locks between multiple users, not between clients\n  - The locks created from api\n      * They do not contain a token key or a davLock property\n      * They are exclusive only\n      * They must have a depth of 'infinity' (all children) or '0' (root and root members)\n  - The locks created from WebDAV or OnlyOffice are stored with a token and a davLock property\n      * They must have a depth of 'infinity' (all children) or '0' (root and root members)\n      * They can be exclusive (WebDAV) or shared (OnlyOffice)\n      * If created with WebDAV, they are stored with a token and a davLock property\n      * If created with OnlyOffice, they are stored with no token and a davLock property whose `locktoken` & `lockroot` properties are null\n  Cache token key format = `flock|token?:${uuid}|path:${path}|ownerId?:${number}|spaceId?:${number}|...props` => FileLock\n  */\n  public static readonly defaultLockTimeoutSeconds = 86400 // 1 day\n  private readonly logger = new Logger(FilesLockManager.name)\n\n  constructor(private readonly cache: Cache) {}\n\n  async create(user: UserModel, dbFile: FileDBProps, depth: LOCK_DEPTH, ttl?: number, davLock?: WebDAVLock): Promise<[boolean, FileLock]> {\n    let token: string\n    let lockscope: LOCK_SCOPE\n    if (davLock) {\n      // webdav context\n      davLock.locktoken = this.genDAVToken()\n      token = davLock.locktoken\n      lockscope = davLock.lockscope\n    } else {\n      // api context\n      token = null\n      lockscope = null\n    }\n    try {\n      await this.checkConflicts(dbFile, depth, { lockScope: lockscope })\n    } catch (e) {\n      if (e instanceof LockConflict) {\n        return [false, e.lock]\n      }\n      throw new Error(e)\n    }\n    ttl ??= FilesLockManager.defaultLockTimeoutSeconds\n    const key = `${CACHE_LOCK_PREFIX}|${this.genSuffixKey(dbFile, { depth: depth, token: token })}`\n    const expiration = Math.floor(currentTimeStamp() + ttl)\n    const lock: FileLock = {\n      owner: user.asOwner(),\n      dbFilePath: dbFile.path,\n      key: key,\n      depth: depth,\n      expiration: expiration,\n      davLock: davLock\n    }\n    this.logger.verbose(`${this.create.name} - ${key}`)\n    await this.cache.set(key, lock, ttl)\n    return [true, lock]\n  }\n\n  removeLock(key: string): Promise<boolean> {\n    this.logger.verbose(`${this.removeLock.name} - ${key}`)\n    return this.cache.del(key)\n  }\n\n  async removeChildLocks(user: UserModel, dbFile: FileDBProps) {\n    const ownedLockKeys: string[] = []\n    for await (const lock of this.searchChildLocks(dbFile)) {\n      if (user.id === lock.owner.id) {\n        ownedLockKeys.push(lock.key)\n        continue\n      }\n      const conflict = `cannot remove conflicting child lock : ${dbFile.path} (${user.login}) -> ${lock.dbFilePath} (${lock.owner.login})`\n      this.logger.debug(`${this.removeChildLocks.name} - ${conflict}`)\n      throw new LockConflict(lock, conflict)\n    }\n    for (const key of ownedLockKeys) {\n      this.logger.verbose(`${this.removeChildLocks.name} - child locks: ${key}`)\n      await this.removeLock(key)\n    }\n  }\n\n  async isLockedWithToken(token: string, dbFilePath: string): Promise<FileLock> {\n    // check if url (or any of its parents) is locked by the token\n    const lock = await this.getLockByToken(token)\n    return lock ? (dbFilePath.startsWith(lock.dbFilePath) ? lock : null) : null\n  }\n\n  async browseParentChildLocks(dbFile: FileDBProps, includeRoot = true): Promise<Record<string, FileLock>> {\n    // find child locks inside the path\n    const childLocks: Record<string, FileLock> = includeRoot ? await this.browseLocks(dbFile) : {}\n    const lengthFilter = dbFile.path === '.' ? 1 : dbFile.path.split('/').length + 1\n    for await (const lock of this.searchChildLocks(dbFile)) {\n      // filter child locks on length\n      if (lengthFilter === lock.dbFilePath.split('/').length) {\n        // !!! locks with shared scope can have the same file name, in this case we only keep the first entry\n        const dbFileName = fileName(lock.dbFilePath)\n        if (!(dbFileName in childLocks)) {\n          childLocks[fileName(lock.dbFilePath)] = lock\n        }\n      }\n    }\n    return childLocks\n  }\n\n  async browseLocks(dbFile: FileDBProps): Promise<Record<string, FileLock>> {\n    return Object.fromEntries((await this.getLocksByPath(dbFile)).map((l) => [fileName(l.dbFilePath), l]))\n  }\n\n  async refreshLockTimeout(lock: FileLock, ttl: number) {\n    lock.expiration = currentTimeStamp() + ttl\n    this.cache.set(lock.key, lock, ttl).catch((e: Error) => this.logger.error(`${this.refreshLockTimeout.name} - ${e}`))\n  }\n\n  async getLockByToken(token: string): Promise<FileLock> {\n    const key = await this.searchKeyByToken(token)\n    return key ? (await this.cache.get(key)) || null : null\n  }\n\n  async getLocksByPath(dbFile: FileDBProps): Promise<FileLock[]> {\n    if (dbFile.path !== '.') {\n      const props = this.genSuffixKey(dbFile, { ignorePath: true })\n      const keys = await this.searchKeysByPath(dbFile.path, props)\n      if (keys.length) {\n        return (await this.cache.mget(keys)).filter(Boolean)\n      }\n    }\n    return []\n  }\n\n  async isPathLocked(dbFile: FileDBProps): Promise<boolean> {\n    if (dbFile.path !== '.') return false\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    return !!(await this.searchKeysByPath(dbFile.path, props)).length\n  }\n\n  async checkConflicts(\n    dbFile: FileDBProps,\n    depth: LOCK_DEPTH,\n    options?: { userId?: number; lockScope?: LOCK_SCOPE; lockTokens?: string[] }\n  ): Promise<void> {\n    /* Checks if a file could be modified, created, moved, or deleted\n       Throws an `LockConflict` error when there are parent locks (depth: 0) or child locks (depth: infinite) that prevent modifications\n       Returns on the first conflict (compliant with the RFC 4918)\n    */\n    for await (const l of this.searchParentLocks(dbFile, { includeRoot: true, depth: DEPTH.INFINITY })) {\n      if (options?.lockScope && options?.lockScope === LOCK_SCOPE.SHARED && l.davLock.lockscope === LOCK_SCOPE.SHARED) {\n        // Only compatible with shared locks (even by same owner)\n        continue\n      }\n      if (options?.userId === l.owner.id && (!l.davLock || (options?.lockTokens?.length && options.lockTokens.indexOf(l.davLock.locktoken) > -1))) {\n        // Owner owns this lock (no davLock if the lock was created from api)\n        continue\n      }\n      const conflict = `conflicting parent lock : ${dbFile.path} -> ${l.dbFilePath} (${l.owner.login})`\n      this.logger.debug(`${this.checkConflicts.name} - ${conflict}`)\n      throw new LockConflict(l, conflict)\n    }\n    if (depth === DEPTH.INFINITY) {\n      for await (const l of this.searchChildLocks(dbFile)) {\n        if (options?.userId === l.owner.id && (!l.davLock || (options?.lockTokens?.length && options.lockTokens.indexOf(l.davLock.locktoken) > -1))) {\n          // Owner owns this lock (no davLock if the lock was created from api)\n          continue\n        }\n        const conflict = `conflicting child lock : ${dbFile.path} -> ${l.dbFilePath} (${l.owner.login})`\n        this.logger.debug(`${this.checkConflicts.name} - ${conflict}`)\n        throw new LockConflict(l, conflict)\n      }\n    }\n  }\n\n  private async *searchParentLocks(dbFile: FileDBProps, options: { includeRoot?: boolean; depth?: LOCK_DEPTH } = {}): AsyncGenerator<FileLock> {\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    let path = dbFile.path\n    const parentPath = dirName(path)\n    this.logger.verbose(`${this.searchParentLocks.name} - (including root : ${options.includeRoot}) : ${path} (${props})`)\n    if (!options.includeRoot) {\n      path = dirName(path)\n    }\n    while (path !== '.') {\n      // Even if the depth is \"infinite\", the path and the parent path could be locked with depth \"0\"\n      const depth = options.depth && (dbFile.path === path || parentPath === path) ? null : options.depth\n      const keys = await this.searchKeysByPath(path, props, depth)\n      if (keys.length) {\n        for (const l of (await this.cache.mget(keys)).filter(Boolean) as FileLock[]) {\n          this.logger.verbose(`-> ${l.dbFilePath}`)\n          yield l\n        }\n      }\n      path = dirName(path)\n    }\n  }\n\n  async *searchChildLocks(dbFile: FileDBProps) {\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    const path = dbFile.path === '.' ? '*' : `${dbFile.path}/*`\n    this.logger.verbose(`${this.searchChildLocks.name} - ${path} (${props})`)\n    const keys = await this.searchKeysByPath(path, props)\n    if (keys.length) {\n      for (const l of (await this.cache.mget(keys)).filter(Boolean) as FileLock[]) {\n        this.logger.verbose(`-> ${l.dbFilePath} (owner: ${l.owner.login})`)\n        yield l\n      }\n    }\n  }\n\n  private async searchKeyByToken(token: string): Promise<string> {\n    const keys = await this.cache.keys(`${CACHE_LOCK_PREFIX}|token:${token}|*`)\n    if (!keys.length) {\n      return null\n    } else if (keys.length > 1) {\n      this.logger.warn(`Several keys found for token : ${token} => ${JSON.stringify(keys)}`)\n    }\n    return keys[0]\n  }\n\n  private searchKeysByPath(path: string, props = '*', depth?: LOCK_DEPTH): Promise<string[]> {\n    return this.cache.keys(`${CACHE_LOCK_PREFIX}*${depth ? `|depth:${depth}` : ''}|path:${path}|${props}`)\n  }\n\n  private genDAVToken(): string {\n    return `${LOCK_PREFIX}${crypto.randomUUID()}`\n  }\n\n  private genSuffixKey(dbFile: FileDBProps, options: { ignorePath?: boolean; depth?: LOCK_DEPTH; token?: string } = {}): string {\n    // return -> `depth:infinity|path:code/sync-in|spaceId:1` | `token:xxx|depth:0|path:code/sync-in.ts|ownerId:1`\n    // ignorePath -> `spaceId:1`\n    const suffixes = []\n    for (const k of Object.keys(dbFile)\n      .filter((k) => k !== files.inTrash.name && dbFile[k] !== null)\n      .sort()) {\n      if (k === files.path.name) {\n        if (options.ignorePath) {\n          continue\n        }\n        suffixes.unshift(`${k}:${dbFile[k]}`)\n      } else {\n        suffixes.push(`${k}:${dbFile[k]}`)\n      }\n    }\n    if (options.depth) suffixes.unshift(`depth:${options.depth}`)\n    if (options.token) suffixes.unshift(`token:${options.token}`)\n    return suffixes.join('|')\n  }\n}\n"],"names":["FilesLockManager","create","user","dbFile","depth","ttl","davLock","token","lockscope","locktoken","genDAVToken","checkConflicts","lockScope","e","LockConflict","lock","Error","defaultLockTimeoutSeconds","key","CACHE_LOCK_PREFIX","genSuffixKey","expiration","Math","floor","currentTimeStamp","owner","asOwner","dbFilePath","path","logger","verbose","name","cache","set","removeLock","del","removeChildLocks","ownedLockKeys","searchChildLocks","id","push","conflict","login","debug","isLockedWithToken","getLockByToken","startsWith","browseParentChildLocks","includeRoot","childLocks","browseLocks","lengthFilter","split","length","dbFileName","fileName","Object","fromEntries","getLocksByPath","map","l","refreshLockTimeout","catch","error","searchKeyByToken","get","props","ignorePath","keys","searchKeysByPath","mget","filter","Boolean","isPathLocked","options","searchParentLocks","DEPTH","INFINITY","LOCK_SCOPE","SHARED","userId","lockTokens","indexOf","parentPath","dirName","warn","JSON","stringify","LOCK_PREFIX","crypto","randomUUID","suffixes","k","files","inTrash","sort","unshift","join","Logger"],"mappings":"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"}
+{"version":3,"sources":["../../../../../backend/src/applications/files/services/files-lock-manager.service.ts"],"sourcesContent":["/*\n * Copyright (C) 2012-2025 Johan Legrand <johan.legrand@sync-in.com>\n * This file is part of Sync-in | The open source file sync and share solution\n * See the LICENSE file for licensing details\n */\n\nimport { Injectable, Logger } from '@nestjs/common'\nimport crypto from 'node:crypto'\n\nimport { currentTimeStamp } from '../../../common/shared'\nimport { Cache } from '../../../infrastructure/cache/services/cache.service'\nimport { UserModel } from '../../users/models/user.model'\nimport { DEPTH, LOCK_DEPTH, LOCK_PREFIX, LOCK_SCOPE } from '../../webdav/constants/webdav'\nimport { WebDAVLock } from '../../webdav/interfaces/webdav.interface'\nimport { CACHE_LOCK_DEFAULT_TTL, CACHE_LOCK_PREFIX } from '../constants/cache'\nimport { FileDBProps } from '../interfaces/file-db-props.interface'\nimport { FileLock } from '../interfaces/file-lock.interface'\nimport { FileLockProps } from '../interfaces/file-props.interface'\nimport { LockConflict } from '../models/file-lock-error'\nimport { files } from '../schemas/files.schema'\nimport { dirName, fileName } from '../utils/files'\n\n@Injectable()\nexport class FilesLockManager {\n  /* Philosophy\n  Currently this manager only handle conflicting locks between multiple users, not between clients\n  - The locks created from api\n      * They do not contain a token key or a davLock property\n      * They are exclusive only\n      * They must have a depth of 'infinity' (all children) or '0' (root and root members)\n  - The locks created from WebDAV or OnlyOffice are stored with a token and a davLock property\n      * They must have a depth of 'infinity' (all children) or '0' (root and root members)\n      * They can be exclusive (WebDAV) or shared (OnlyOffice)\n      * If created with WebDAV, they are stored with a token and a davLock property\n      * If created with OnlyOffice, they are stored with no token and a davLock property whose `locktoken` & `lockroot` properties are null\n  Cache token key format = `flock|token?:${uuid}|path:${path}|ownerId?:${number}|spaceId?:${number}|...props` => FileLock\n  */\n  private readonly logger = new Logger(FilesLockManager.name)\n\n  constructor(private readonly cache: Cache) {}\n\n  async create(user: UserModel, dbFile: FileDBProps, depth: LOCK_DEPTH, davLock?: WebDAVLock, ttl?: number): Promise<[boolean, FileLock]> {\n    let token: string\n    let lockscope: LOCK_SCOPE\n    if (davLock) {\n      // webdav context\n      davLock.locktoken = this.genDAVToken()\n      token = davLock.locktoken\n      lockscope = davLock.lockscope\n    } else {\n      // api context\n      token = null\n      lockscope = null\n    }\n    try {\n      await this.checkConflicts(dbFile, depth, { lockScope: lockscope })\n    } catch (e) {\n      if (e instanceof LockConflict) {\n        return [false, e.lock]\n      }\n      throw new Error(e)\n    }\n    ttl ??= CACHE_LOCK_DEFAULT_TTL\n    const key = `${CACHE_LOCK_PREFIX}|${this.genSuffixKey(dbFile, { depth: depth, token: token })}`\n    const expiration = Math.floor(currentTimeStamp() + ttl)\n    const lock: FileLock = {\n      owner: user.asOwner(),\n      dbFilePath: dbFile.path,\n      key: key,\n      depth: depth,\n      expiration: expiration,\n      davLock: davLock\n    }\n    this.logger.verbose(`${this.create.name} - ${key}`)\n    await this.cache.set(key, lock, ttl)\n    return [true, lock]\n  }\n\n  async createOrRefresh(user: UserModel, dbFile: FileDBProps, depth: LOCK_DEPTH, ttl?: number): Promise<[boolean, FileLock]> {\n    // Returns: [created, lock]\n    ttl ??= CACHE_LOCK_DEFAULT_TTL\n    const locks = await this.getLocksByPath(dbFile)\n    // Check the existing lock and refresh it if needed\n    if (locks.length > 0) {\n      for (const lock of locks) {\n        if (lock.owner.id === user.id) {\n          // Refresh if more than half of the TTL has passed\n          const mustRefresh = lock.expiration - currentTimeStamp() < ttl / 2\n          if (mustRefresh) {\n            this.refreshLockTimeout(lock, ttl).catch((e: Error) => this.logger.error(`${this.createOrRefresh.name} - ${e}`))\n          }\n        } else {\n          throw new LockConflict(lock, 'Conflicting lock')\n        }\n      }\n      return [false, locks[0]]\n    }\n    // Create the lock\n    const [ok, lock] = await this.create(user, dbFile, depth, null, ttl)\n    if (!ok) {\n      throw new LockConflict(lock, 'Conflicting lock')\n    }\n    return [true, lock]\n  }\n\n  removeLock(key: string): Promise<boolean> {\n    this.logger.verbose(`${this.removeLock.name} - ${key}`)\n    return this.cache.del(key)\n  }\n\n  async removeChildLocks(user: UserModel, dbFile: FileDBProps) {\n    const ownedLockKeys: string[] = []\n    for await (const lock of this.searchChildLocks(dbFile)) {\n      if (user.id === lock.owner.id) {\n        ownedLockKeys.push(lock.key)\n        continue\n      }\n      const conflict = `cannot remove conflicting child lock : ${dbFile.path} (${user.login}) -> ${lock.dbFilePath} (${lock.owner.login})`\n      this.logger.debug(`${this.removeChildLocks.name} - ${conflict}`)\n      throw new LockConflict(lock, conflict)\n    }\n    for (const key of ownedLockKeys) {\n      this.logger.verbose(`${this.removeChildLocks.name} - child locks: ${key}`)\n      await this.removeLock(key)\n    }\n  }\n\n  async isLockedWithToken(token: string, dbFilePath: string): Promise<FileLock> {\n    // check if url (or any of its parents) is locked by the token\n    const lock = await this.getLockByToken(token)\n    return lock ? (dbFilePath.startsWith(lock.dbFilePath) ? lock : null) : null\n  }\n\n  async browseParentChildLocks(dbFile: FileDBProps, includeRoot = true): Promise<Record<string, FileLock>> {\n    // find child locks inside the path\n    const childLocks: Record<string, FileLock> = includeRoot ? await this.browseLocks(dbFile) : {}\n    const lengthFilter = dbFile.path === '.' ? 1 : dbFile.path.split('/').length + 1\n    for await (const lock of this.searchChildLocks(dbFile)) {\n      // filter child locks on length\n      if (lengthFilter === lock.dbFilePath.split('/').length) {\n        // !!! locks with shared scope can have the same file name, in this case we only keep the first entry\n        const dbFileName = fileName(lock.dbFilePath)\n        if (!(dbFileName in childLocks)) {\n          childLocks[fileName(lock.dbFilePath)] = lock\n        }\n      }\n    }\n    return childLocks\n  }\n\n  async browseLocks(dbFile: FileDBProps): Promise<Record<string, FileLock>> {\n    return Object.fromEntries((await this.getLocksByPath(dbFile)).map((l) => [fileName(l.dbFilePath), l]))\n  }\n\n  async refreshLockTimeout(lock: FileLock, ttl: number) {\n    lock.expiration = currentTimeStamp() + ttl\n    this.cache.set(lock.key, lock, ttl).catch((e: Error) => this.logger.error(`${this.refreshLockTimeout.name} - ${e}`))\n  }\n\n  async getLockByToken(token: string): Promise<FileLock> {\n    const key = await this.searchKeyByToken(token)\n    return key ? (await this.cache.get(key)) || null : null\n  }\n\n  async getLocksByPath(dbFile: FileDBProps): Promise<FileLock[]> {\n    if (dbFile.path !== '.') {\n      const props = this.genSuffixKey(dbFile, { ignorePath: true })\n      const keys = await this.searchKeysByPath(dbFile.path, props)\n      if (keys.length) {\n        return (await this.cache.mget(keys)).filter(Boolean)\n      }\n    }\n    return []\n  }\n\n  async isPathLocked(dbFile: FileDBProps): Promise<boolean> {\n    if (dbFile.path !== '.') return false\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    return !!(await this.searchKeysByPath(dbFile.path, props)).length\n  }\n\n  async checkConflicts(\n    dbFile: FileDBProps,\n    depth: LOCK_DEPTH,\n    options?: { userId?: number; lockScope?: LOCK_SCOPE; lockTokens?: string[] }\n  ): Promise<void> {\n    /* Checks if a file could be modified, created, moved, or deleted\n       Throws an `LockConflict` error when there are parent locks (depth: 0) or child locks (depth: infinite) that prevent modification\n       Returns on the first conflict (compliant with the RFC 4918)\n    */\n    for await (const l of this.searchParentLocks(dbFile, { includeRoot: true, depth: DEPTH.INFINITY })) {\n      if (options?.lockScope && options?.lockScope === LOCK_SCOPE.SHARED && l.davLock.lockscope === LOCK_SCOPE.SHARED) {\n        // Only compatible with shared locks (even by same owner)\n        continue\n      }\n      if (options?.userId === l.owner.id && (!l.davLock || (options?.lockTokens?.length && options.lockTokens.indexOf(l.davLock.locktoken) > -1))) {\n        // Owner owns this lock (no davLock if the lock was created from api)\n        continue\n      }\n      const conflict = `conflicting parent lock : ${dbFile.path} -> ${l.dbFilePath} (${l.owner.login})`\n      this.logger.debug(`${this.checkConflicts.name} - ${conflict}`)\n      throw new LockConflict(l, conflict)\n    }\n    if (depth === DEPTH.INFINITY) {\n      for await (const l of this.searchChildLocks(dbFile)) {\n        if (options?.userId === l.owner.id && (!l.davLock || (options?.lockTokens?.length && options.lockTokens.indexOf(l.davLock.locktoken) > -1))) {\n          // Owner owns this lock (no davLock if the lock was created from api)\n          continue\n        }\n        const conflict = `conflicting child lock : ${dbFile.path} -> ${l.dbFilePath} (${l.owner.login})`\n        this.logger.debug(`${this.checkConflicts.name} - ${conflict}`)\n        throw new LockConflict(l, conflict)\n      }\n    }\n  }\n\n  async *searchChildLocks(dbFile: FileDBProps) {\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    const path = dbFile.path === '.' ? '*' : `${dbFile.path}/*`\n    this.logger.verbose(`${this.searchChildLocks.name} - ${path} (${props})`)\n    const keys = await this.searchKeysByPath(path, props)\n    if (keys.length) {\n      for (const l of (await this.cache.mget(keys)).filter(Boolean) as FileLock[]) {\n        this.logger.verbose(`-> ${l.dbFilePath} (owner: ${l.owner.login})`)\n        yield l\n      }\n    }\n  }\n\n  convertLockToFileLockProps(lock: FileLock): FileLockProps {\n    if (!lock) return null\n    return {\n      owner: lock?.davLock?.owner || `${lock.owner.fullName} (${lock.owner.email})`,\n      ownerLogin: lock.owner.login,\n      isExclusive: lock?.davLock?.lockscope ? lock?.davLock?.lockscope === LOCK_SCOPE.EXCLUSIVE : true\n    }\n  }\n\n  private async *searchParentLocks(dbFile: FileDBProps, options: { includeRoot?: boolean; depth?: LOCK_DEPTH } = {}): AsyncGenerator<FileLock> {\n    const props = this.genSuffixKey(dbFile, { ignorePath: true })\n    let path = dbFile.path\n    const parentPath = dirName(path)\n    this.logger.verbose(`${this.searchParentLocks.name} - (including root : ${options.includeRoot}) : ${path} (${props})`)\n    if (!options.includeRoot) {\n      path = dirName(path)\n    }\n    while (path !== '.') {\n      // Even if the depth is \"infinite\", the path and the parent path could be locked with depth \"0\"\n      const depth = options.depth && (dbFile.path === path || parentPath === path) ? null : options.depth\n      const keys = await this.searchKeysByPath(path, props, depth)\n      if (keys.length) {\n        for (const l of (await this.cache.mget(keys)).filter(Boolean) as FileLock[]) {\n          this.logger.verbose(`-> ${l.dbFilePath}`)\n          yield l\n        }\n      }\n      path = dirName(path)\n    }\n  }\n\n  private async searchKeyByToken(token: string): Promise<string> {\n    const keys = await this.cache.keys(`${CACHE_LOCK_PREFIX}|token:${token}|*`)\n    if (!keys.length) {\n      return null\n    } else if (keys.length > 1) {\n      this.logger.warn(`Several keys found for token : ${token} => ${JSON.stringify(keys)}`)\n    }\n    return keys[0]\n  }\n\n  private searchKeysByPath(path: string, props = '*', depth?: LOCK_DEPTH): Promise<string[]> {\n    return this.cache.keys(`${CACHE_LOCK_PREFIX}*${depth ? `|depth:${depth}` : ''}|path:${path}|${props}`)\n  }\n\n  private genDAVToken(): string {\n    return `${LOCK_PREFIX}${crypto.randomUUID()}`\n  }\n\n  private genSuffixKey(dbFile: FileDBProps, options: { ignorePath?: boolean; depth?: LOCK_DEPTH; token?: string } = {}): string {\n    // return -> `depth:infinity|path:code/sync-in|spaceId:1` | `token:xxx|depth:0|path:code/sync-in.ts|ownerId:1`\n    // ignorePath -> `spaceId:1`\n    const suffixes = []\n    for (const k of Object.keys(dbFile)\n      .filter((k) => k !== files.inTrash.name && dbFile[k] !== null)\n      .sort()) {\n      if (k === files.path.name) {\n        if (options.ignorePath) {\n          continue\n        }\n        suffixes.unshift(`${k}:${dbFile[k]}`)\n      } else {\n        suffixes.push(`${k}:${dbFile[k]}`)\n      }\n    }\n    if (options.depth) suffixes.unshift(`depth:${options.depth}`)\n    if (options.token) suffixes.unshift(`token:${options.token}`)\n    return suffixes.join('|')\n  }\n}\n"],"names":["FilesLockManager","create","user","dbFile","depth","davLock","ttl","token","lockscope","locktoken","genDAVToken","checkConflicts","lockScope","e","LockConflict","lock","Error","CACHE_LOCK_DEFAULT_TTL","key","CACHE_LOCK_PREFIX","genSuffixKey","expiration","Math","floor","currentTimeStamp","owner","asOwner","dbFilePath","path","logger","verbose","name","cache","set","createOrRefresh","locks","getLocksByPath","length","id","mustRefresh","refreshLockTimeout","catch","error","ok","removeLock","del","removeChildLocks","ownedLockKeys","searchChildLocks","push","conflict","login","debug","isLockedWithToken","getLockByToken","startsWith","browseParentChildLocks","includeRoot","childLocks","browseLocks","lengthFilter","split","dbFileName","fileName","Object","fromEntries","map","l","searchKeyByToken","get","props","ignorePath","keys","searchKeysByPath","mget","filter","Boolean","isPathLocked","options","searchParentLocks","DEPTH","INFINITY","LOCK_SCOPE","SHARED","userId","lockTokens","indexOf","convertLockToFileLockProps","fullName","email","ownerLogin","isExclusive","EXCLUSIVE","parentPath","dirName","warn","JSON","stringify","LOCK_PREFIX","crypto","randomUUID","suffixes","k","files","inTrash","sort","unshift","join","Logger"],"mappings":"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"}

package/server/applications/files/services/files-manager.service.js

@@ -17,14 +17,18 @@ const _common = require("@nestjs/common");
 const _archiver = /*#__PURE__*/ _interop_require_default(require("archiver"));
 const _nodefs = /*#__PURE__*/ _interop_require_default(require("node:fs"));
 const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
-const _promises = require("node:stream/promises");
 const _tar = require("tar");
 const _image = require("../../../common/image");
+const _contextmanagerservice = require("../../../infrastructure/context/services/context-manager.service");
 const _applicationsconstants = require("../../applications.constants");
+const _notifications = require("../../notifications/constants/notifications");
+const _notificationsmanagerservice = require("../../notifications/services/notifications-manager.service");
 const _spaces = require("../../spaces/constants/spaces");
+const _spacesmanagerservice = require("../../spaces/services/spaces-manager.service");
 const _paths = require("../../spaces/utils/paths");
 const _permissions = require("../../spaces/utils/permissions");
 const _webdav = require("../../webdav/constants/webdav");
+const _cache = require("../constants/cache");
 const _compress = require("../constants/compress");
 const _files = require("../constants/files");
 const _operations = require("../constants/operations");
@@ -142,11 +146,16 @@ let FilesManager = class FilesManager {
     }
     async saveMultipart(user, space, req) {
         /* Accepted methods:
-        POST: create new resource
-        PUT: create or update new resource (even if parent path does not exist)
-    */ const realParentPath = (0, _files1.dirName)(space.realPath);
-        if (req.method === _applicationsconstants.HTTP_METHOD.POST) {
-            if (await (0, _files1.isPathExists)(space.realPath)) {
+        POST: Creates new resource
+        PUT: Creates or fully replaces a resource at the given URI (even if intermediate paths do not exist)
+        PATCH: Updates the content of an existing resource without creating a new one.
+               In this text-editing scenario, locking and refreshing occur automatically, but unlocking must be handled explicitly via
+               the `unlock` method.
+    */ const overwrite = req.method === _applicationsconstants.HTTP_METHOD.PUT;
+        const patch = req.method === _applicationsconstants.HTTP_METHOD.PATCH;
+        const realParentPath = (0, _files1.dirName)(space.realPath);
+        if (!overwrite) {
+            if (!patch && await (0, _files1.isPathExists)(space.realPath)) {
                 throw new _fileerror.FileError(_common.HttpStatus.BAD_REQUEST, 'Resource already exists');
             }
             if (!await (0, _files1.isPathExists)(realParentPath)) {
@@ -158,31 +167,53 @@ let FilesManager = class FilesManager {
         }
         const basePath = realParentPath + _nodepath.default.sep;
         for await (const part of req.files()){
-            // part.filename may contain a path like foo/bar.txt.
-            const dstFile = _nodepath.default.resolve(basePath, part.filename);
-            // prevent path traversal
+            // If the request uses the PATCH method, the file name corresponds to the space
+            const partFileName = patch ? (0, _files1.fileName)(space.realPath) : part.filename;
+            // `part.filename` may contain a path like foo/bar.txt
+            const dstFile = _nodepath.default.resolve(basePath, partFileName);
+            // Prevent path traversal
             if (!dstFile.startsWith(basePath)) {
                 throw new _fileerror.FileError(_common.HttpStatus.FORBIDDEN, 'Location is not allowed');
             }
-            // make dir in space
             const dstDir = (0, _files1.dirName)(dstFile);
+            if (overwrite) {
+                // Prevent errors when an uploaded file would replace a directory with the same name
+                // Only applies in `overwrite` cases
+                if (await (0, _files1.isPathExists)(dstFile) && await (0, _files1.isPathIsDir)(dstFile)) {
+                    // If a directory already exists at the destination path, delete it to allow overwriting with the uploaded file
+                    const dstUrl = _nodepath.default.join(_nodepath.default.dirname(space.url), partFileName);
+                    const dstSpace = await this.spacesManager.spaceEnv(user, dstUrl.split('/'));
+                    await this.delete(user, dstSpace);
+                } else if (await (0, _files1.isPathExists)(dstDir) && !await (0, _files1.isPathIsDir)(dstDir)) {
+                    // If the destination's parent exists but is a file, remove it so we can create the directory
+                    const dstUrl = _nodepath.default.join(_nodepath.default.dirname(space.url), _nodepath.default.dirname(partFileName));
+                    const dstSpace = await this.spacesManager.spaceEnv(user, dstUrl.split('/'));
+                    await this.delete(user, dstSpace);
+                }
+            }
+            // Create the directory in the space
             if (!await (0, _files1.isPathExists)(dstDir)) {
                 await (0, _files1.makeDir)(dstDir, true);
             }
-            // create lock
+            // Create or refresh lock
             const dbFile = {
                 ...space.dbFile,
-                path: _nodepath.default.join((0, _files1.dirName)(space.dbFile.path), part.filename)
+                path: _nodepath.default.join((0, _files1.dirName)(space.dbFile.path), partFileName)
             };
-            const [ok, fileLock] = await this.filesLockManager.create(user, dbFile, _webdav.DEPTH.RESOURCE);
-            if (!ok) throw new _filelockerror.LockConflict(fileLock, 'Conflicting lock');
-            // do
+            // Use a short TTL for the PATCH method (which is also used for refreshing)
+            const ttl = patch ? _cache.CACHE_LOCK_FILE_TTL : undefined;
+            const [created, fileLock] = await this.filesLockManager.createOrRefresh(user, dbFile, _webdav.DEPTH.RESOURCE, ttl);
+            // Do
             try {
-                await (0, _promises.pipeline)(part.file, _nodefs.default.createWriteStream(dstFile, {
-                    highWaterMark: _files.DEFAULT_HIGH_WATER_MARK
-                }));
+                await (0, _files1.writeFromStream)(dstFile, part.file);
             } finally{
-                await this.filesLockManager.removeLock(fileLock.key);
+                if (!patch && created) {
+                    // Remove the file lock only if it has not been refreshed
+                    await this.filesLockManager.removeLock(fileLock.key);
+                }
+            }
+            if (patch) {
+                break;
             }
         }
     }
@@ -212,7 +243,7 @@ let FilesManager = class FilesManager {
         const fileExtension = _nodepath.default.extname(space.realPath);
         if (checkDocument && fileExtension !== '.txt' && Object.values(_samples.DOCUMENT_TYPE).indexOf(fileExtension) > -1) {
             const srcSample = _nodepath.default.join(__dirname, `${_samples.SAMPLE_PATH_WITHOUT_EXT}${fileExtension}`);
-            return (0, _files1.copyFiles)(srcSample, space.realPath, false, false, false);
+            return (0, _files1.copyFileContent)(srcSample, space.realPath);
         } else {
             return (0, _files1.createEmptyFile)(space.realPath);
         }
@@ -370,12 +401,12 @@ let FilesManager = class FilesManager {
                         ...trashFileDB,
                         path: _nodepath.default.join((0, _files1.dirName)(trashFileDB.path), (0, _files1.fileName)(dstTrash.path))
                     };
-                    this.filesQueries.moveFiles(trashFileDB, dstTrashFileDB, dstTrash.isDir).catch((e)=>this.logger.error(`${this.delete.name} - ${e}`));
+                    await this.filesQueries.moveFiles(trashFileDB, dstTrashFileDB, dstTrash.isDir);
                 }
                 await (0, _files1.moveFiles)(space.realPath, trashFile, true);
             } else {
-                this.logger.log(`Unable to find trash path for space - *${space.alias}* (${space.id}) : delete permanently : ${space.realPath}`);
-                // todo: define a default trash for external paths
+                // unsupported case: delete the file (this shouldn't happen)
+                this.logger.error(`Unable to find trash path for space - *${space.alias}* (${space.id}) : delete permanently : ${space.realPath}`);
                 forceDeleteInDB = true;
                 await (0, _files1.removeFiles)(space.realPath);
             }
@@ -553,9 +584,73 @@ let FilesManager = class FilesManager {
             throw new _fileerror.FileError(_common.HttpStatus.BAD_REQUEST, 'File is not an image');
         }
     }
-    constructor(http, filesQueries, filesLockManager){
+    async lock(user, space) {
+        const rExists = await (0, _files1.isPathExists)(space.realPath);
+        if (!rExists) {
+            this.logger.warn('Lock refresh must specify an existing resource');
+            throw new _fileerror.FileError(_common.HttpStatus.BAD_REQUEST, 'Lock refresh must specify an existing resource');
+        }
+        const [_created, lock] = await this.filesLockManager.createOrRefresh(user, space.dbFile, _webdav.DEPTH.RESOURCE, _cache.CACHE_LOCK_FILE_TTL);
+        return this.filesLockManager.convertLockToFileLockProps(lock);
+    }
+    async unlock(user, space, forceAsOwner = false) {
+        if (!await (0, _files1.isPathExists)(space.realPath)) {
+            this.logger.warn(`Unable to unlock: ${space.url} - resource does not exist`);
+            throw new _fileerror.FileError(_common.HttpStatus.BAD_REQUEST, 'Unlock must specify an existing resource');
+        }
+        const fileLocks = await this.filesLockManager.getLocksByPath(space.dbFile);
+        if (fileLocks.length === 0) {
+            this.logger.warn(`Unable to find lock: ${space.url} - resource does not exist`);
+            return;
+        }
+        for (const lock of fileLocks){
+            if (forceAsOwner && space.dbFile?.ownerId === user.id || lock.owner.id === user.id) {
+                // Refresh if more than half of the TTL has passed
+                await this.filesLockManager.removeLock(lock.key);
+            } else {
+                throw new _filelockerror.LockConflict(lock, 'Conflicting lock');
+            }
+        }
+    }
+    async unlockRequest(user, space) {
+        const fileLocks = await this.filesLockManager.getLocksByPath(space.dbFile);
+        if (fileLocks.length === 0) {
+            this.logger.warn(`Unable to find lock: ${space.url} - resource does not exist`);
+            throw new _fileerror.FileError(_common.HttpStatus.NOT_FOUND, 'Lock not found');
+        }
+        for (const lock of fileLocks){
+            if (lock.owner.id !== user.id) {
+                const notification = {
+                    app: _notifications.NOTIFICATION_APP.UNLOCK_REQUEST,
+                    event: _notifications.NOTIFICATION_APP_EVENT.UNLOCK_REQUEST,
+                    element: (0, _files1.fileName)(space.url),
+                    url: (0, _files1.dirName)(space.url)
+                };
+                this.notificationsManager.create([
+                    lock.owner.id
+                ], notification, {
+                    author: user,
+                    currentUrl: this.contextManager.headerOriginUrl()
+                }).catch((e)=>this.logger.error(`${this.unlockRequest.name} - ${e}`));
+            }
+        }
+    }
+    async getSize(space) {
+        if (!await (0, _files1.isPathExists)(space.realPath)) {
+            throw new _fileerror.FileError(_common.HttpStatus.NOT_FOUND, 'Location not found');
+        }
+        if (await (0, _files1.isPathIsDir)(space.realPath)) {
+            return (await (0, _files1.dirSize)(space.realPath))[0];
+        } else {
+            return await (0, _files1.fileSize)(space.realPath);
+        }
+    }
+    constructor(http, filesQueries, spacesManager, contextManager, notificationsManager, filesLockManager){
         this.http = http;
         this.filesQueries = filesQueries;
+        this.spacesManager = spacesManager;
+        this.contextManager = contextManager;
+        this.notificationsManager = notificationsManager;
         this.filesLockManager = filesLockManager;
         /* Spaces permissions are checked in the space guard, except for the copy/move destination */ this.logger = new _common.Logger(FilesManager.name);
     }
@@ -566,6 +661,9 @@ FilesManager = _ts_decorate([
     _ts_metadata("design:paramtypes", [
         typeof _axios.HttpService === "undefined" ? Object : _axios.HttpService,
         typeof _filesqueriesservice.FilesQueries === "undefined" ? Object : _filesqueriesservice.FilesQueries,
+        typeof _spacesmanagerservice.SpacesManager === "undefined" ? Object : _spacesmanagerservice.SpacesManager,
+        typeof _contextmanagerservice.ContextManager === "undefined" ? Object : _contextmanagerservice.ContextManager,
+        typeof _notificationsmanagerservice.NotificationsManager === "undefined" ? Object : _notificationsmanagerservice.NotificationsManager,
         typeof _fileslockmanagerservice.FilesLockManager === "undefined" ? Object : _fileslockmanagerservice.FilesLockManager
     ])
 ], FilesManager);