@aneuhold/core-ts-lib 2.2.7 → 2.2.8

package/lib/services/FileSystemService/FileSystemService.js

@@ -5,6 +5,7 @@ import { promisify } from 'util';
 import ErrorUtils from '../../utils/ErrorUtils.js';
 import { DR } from '../DependencyRegistry.js';
 import StringService from '../StringService.js';
+import GlobMatchingService from './GlobMatchingService.js';
 const execAsync = promisify(exec);
 /**
  * A service which can be used to interact with the file system, only in build
@@ -18,8 +19,8 @@ export default class FileSystemService {
      *
      * @param folderPath the path to the folder which contains the file that should
      * be updated
-     * @param fileName
-     * @param textToInsert
+     * @param fileName the name of the file to update
+     * @param textToInsert the text to insert into the file
      */
     static async findAndInsertText(folderPath, fileName, textToInsert) {
         const filePath = path.join(folderPath, fileName);
@@ -43,8 +44,8 @@ export default class FileSystemService {
     /**
      * Copies the contents of one folder to another folder.
      *
-     * @param sourceFolderPath
-     * @param targetFolderPath
+     * @param sourceFolderPath the path to the source folder
+     * @param targetFolderPath the path to the target folder
      * @param ignoreExtensions is an array with extensions that should be
      * ignored. For example, if you want to ignore all .ts files, you would pass
      * in ['.ts']. Multi-part extensions like '.spec.ts' are also supported.
@@ -65,32 +66,12 @@ export default class FileSystemService {
             const sourceFile = path.join(sourceFolderPath, sourceFilePath);
             const targetFile = path.join(targetFolderPath, sourceFilePath);
             // Check if the file should be ignored based on extensions
-            if (ignoreExtensions &&
-                FileSystemService.shouldIgnoreFile(sourceFile, ignoreExtensions)) {
+            if (ignoreExtensions && FileSystemService.shouldIgnoreFile(sourceFile, ignoreExtensions)) {
                 return;
             }
             await cp(sourceFile, targetFile, { recursive: true });
         }));
     }
-    /**
-     * Checks if a file should be ignored based on the provided extensions.
-     * Supports both simple extensions (e.g., '.ts') and multi-part extensions (e.g., '.spec.ts').
-     *
-     * @param filePath the path to the file to check
-     * @param ignoreExtensions array of extensions to ignore
-     */
-    static shouldIgnoreFile(filePath, ignoreExtensions) {
-        const fileName = path.basename(filePath);
-        return ignoreExtensions.some((extension) => {
-            // Handle multi-part extensions like '.spec.ts'
-            if (extension.includes('.', 1)) {
-                return fileName.endsWith(extension);
-            }
-            // Handle simple extensions like '.ts'
-            const fileExtension = StringService.getFileNameExtension(filePath);
-            return fileExtension === extension;
-        });
-    }
     static async checkOrCreateFolder(folderPath) {
         try {
             await access(folderPath);
@@ -146,7 +127,11 @@ export default class FileSystemService {
     static async getAllFilePathsRelative(dirPath) {
         const filePaths = await this.getAllFilePaths(dirPath);
         return filePaths.map((filePath) => {
-            return filePath.replace(dirPath, '');
+            const relativePath = filePath.replace(dirPath, '');
+            // Remove leading path separator if present
+            return relativePath.startsWith('/') || relativePath.startsWith('\\')
+                ? relativePath.slice(1)
+                : relativePath;
         });
     }
     /**
@@ -193,6 +178,59 @@ export default class FileSystemService {
         return this.traverseDirectoryTree(startDir, fileName, stopAt, false // findFirst = false
         );
     }
+    /**
+     * Replaces all occurrences of a string in files within a directory.
+     * Supports glob patterns for including/excluding files and handles URL encoding.
+     *
+     * @param options Configuration object for the replacement operation
+     */
+    static async replaceInFiles(options) {
+        const { searchString, replaceString, rootPath, includePatterns = ['**/*'], excludePatterns = ['**/node_modules/**', '**/.*/**'], includeUrlEncoded = true, dryRun = false } = options;
+        DR.logger.info(`Replacing "${searchString}" with "${replaceString}" in ${rootPath}`);
+        if (dryRun) {
+            DR.logger.info('DRY RUN MODE - No files will be modified');
+        }
+        const allFiles = await this.getAllFilePaths(rootPath);
+        const filesToProcess = GlobMatchingService.getMatchingFiles(allFiles, rootPath, includePatterns, excludePatterns);
+        let processedCount = 0;
+        let modifiedCount = 0;
+        for (const filePath of filesToProcess) {
+            try {
+                const content = await readFile(filePath, 'utf8');
+                let hasChanges = false;
+                let updatedContent = content;
+                // Replace the main string
+                if (content.includes(searchString)) {
+                    updatedContent = updatedContent.replaceAll(searchString, replaceString);
+                    hasChanges = true;
+                }
+                // Replace URL-encoded version if requested
+                if (includeUrlEncoded) {
+                    const encodedSearchString = encodeURIComponent(searchString);
+                    const encodedReplaceString = encodeURIComponent(replaceString);
+                    if (updatedContent.includes(encodedSearchString)) {
+                        updatedContent = updatedContent.replaceAll(encodedSearchString, encodedReplaceString);
+                        hasChanges = true;
+                    }
+                }
+                if (hasChanges) {
+                    const relativePath = path.relative(rootPath, filePath);
+                    DR.logger.info(`${dryRun ? 'Would update' : 'Updating'} ${relativePath}...`);
+                    if (!dryRun) {
+                        await writeFile(filePath, updatedContent, 'utf8');
+                    }
+                    modifiedCount++;
+                }
+                processedCount++;
+            }
+            catch (error) {
+                // Skip binary files or files we can't read
+                DR.logger.verbose.info(`Skipping ${filePath}: ${ErrorUtils.getErrorString(error)}`);
+                continue;
+            }
+        }
+        DR.logger.info(`${dryRun ? 'Would process' : 'Processed'} ${processedCount} files, ${dryRun ? 'would modify' : 'modified'} ${modifiedCount} files`);
+    }
     /**
      * Internal helper method that traverses up the directory tree looking for files.
      *
@@ -235,5 +273,24 @@ export default class FileSystemService {
         }
         return results;
     }
+    /**
+     * Checks if a file should be ignored based on the provided extensions.
+     * Supports both simple extensions (e.g., '.ts') and multi-part extensions (e.g., '.spec.ts').
+     *
+     * @param filePath the path to the file to check
+     * @param ignoreExtensions array of extensions to ignore
+     */
+    static shouldIgnoreFile(filePath, ignoreExtensions) {
+        const fileName = path.basename(filePath);
+        return ignoreExtensions.some((extension) => {
+            // Handle multi-part extensions like '.spec.ts'
+            if (extension.includes('.', 1)) {
+                return fileName.endsWith(extension);
+            }
+            // Handle simple extensions like '.ts'
+            const fileExtension = StringService.getFileNameExtension(filePath);
+            return fileExtension === extension;
+        });
+    }
 }
 //# sourceMappingURL=FileSystemService.js.map

package/lib/services/FileSystemService/FileSystemService.js.map

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

package/lib/services/FileSystemService/FileSystemService.ts

@@ -1,23 +1,34 @@
 import { exec } from 'child_process';
-import {
-  access,
-  appendFile,
-  cp,
-  mkdir,
-  readFile,
-  readdir,
-  rm,
-  stat,
-  writeFile
-} from 'fs/promises';
+import { access, appendFile, cp, mkdir, readFile, readdir, rm, stat, writeFile } from 'fs/promises';
 import path from 'path';
 import { promisify } from 'util';
 import ErrorUtils from '../../utils/ErrorUtils.js';
 import { DR } from '../DependencyRegistry.js';
 import StringService from '../StringService.js';
+import GlobMatchingService from './GlobMatchingService.js';
 
 const execAsync = promisify(exec);
 
+/**
+ * Options for the replaceInFiles method
+ */
+export type ReplaceInFilesOptions = {
+  /** The string to search for */
+  searchString: string;
+  /** The string to replace it with */
+  replaceString: string;
+  /** The root directory to search in */
+  rootPath: string;
+  /** Array of glob-like patterns to include (defaults to all files) */
+  includePatterns?: string[];
+  /** Array of glob-like patterns to exclude (defaults to common ignore patterns) */
+  excludePatterns?: string[];
+  /** Whether to also replace URL-encoded versions of the strings */
+  includeUrlEncoded?: boolean;
+  /** If true, only shows what would be changed without making changes */
+  dryRun?: boolean;
+};
+
 /**
  * A service which can be used to interact with the file system, only in build
  * steps.
@@ -30,8 +41,8 @@ export default class FileSystemService {
    *
    * @param folderPath the path to the folder which contains the file that should
    * be updated
-   * @param fileName
-   * @param textToInsert
+   * @param fileName the name of the file to update
+   * @param textToInsert the text to insert into the file
    */
   static async findAndInsertText(
     folderPath: string,
@@ -62,8 +73,8 @@ export default class FileSystemService {
   /**
    * Copies the contents of one folder to another folder.
    *
-   * @param sourceFolderPath
-   * @param targetFolderPath
+   * @param sourceFolderPath the path to the source folder
+   * @param targetFolderPath the path to the target folder
    * @param ignoreExtensions is an array with extensions that should be
    * ignored. For example, if you want to ignore all .ts files, you would pass
    * in ['.ts']. Multi-part extensions like '.spec.ts' are also supported.
@@ -83,8 +94,7 @@ export default class FileSystemService {
     await FileSystemService.checkOrCreateFolder(targetFolderPath);
 
     // Get the files in the source directory
-    const sourceFilePaths =
-      await FileSystemService.getAllFilePathsRelative(sourceFolderPath);
+    const sourceFilePaths = await FileSystemService.getAllFilePathsRelative(sourceFolderPath);
 
     await Promise.all(
       sourceFilePaths.map(async (sourceFilePath) => {
@@ -92,10 +102,7 @@ export default class FileSystemService {
         const targetFile = path.join(targetFolderPath, sourceFilePath);
 
         // Check if the file should be ignored based on extensions
-        if (
-          ignoreExtensions &&
-          FileSystemService.shouldIgnoreFile(sourceFile, ignoreExtensions)
-        ) {
+        if (ignoreExtensions && FileSystemService.shouldIgnoreFile(sourceFile, ignoreExtensions)) {
           return;
         }
 
@@ -104,38 +111,11 @@ export default class FileSystemService {
     );
   }
 
-  /**
-   * Checks if a file should be ignored based on the provided extensions.
-   * Supports both simple extensions (e.g., '.ts') and multi-part extensions (e.g., '.spec.ts').
-   *
-   * @param filePath the path to the file to check
-   * @param ignoreExtensions array of extensions to ignore
-   */
-  private static shouldIgnoreFile(
-    filePath: string,
-    ignoreExtensions: string[]
-  ): boolean {
-    const fileName = path.basename(filePath);
-
-    return ignoreExtensions.some((extension) => {
-      // Handle multi-part extensions like '.spec.ts'
-      if (extension.includes('.', 1)) {
-        return fileName.endsWith(extension);
-      }
-
-      // Handle simple extensions like '.ts'
-      const fileExtension = StringService.getFileNameExtension(filePath);
-      return fileExtension === extension;
-    });
-  }
-
   static async checkOrCreateFolder(folderPath: string): Promise<void> {
     try {
       await access(folderPath);
     } catch {
-      DR.logger.verbose.info(
-        `Directory "${folderPath}" does not exist. Creating it now...`
-      );
+      DR.logger.verbose.info(`Directory "${folderPath}" does not exist. Creating it now...`);
       await mkdir(folderPath, { recursive: true });
     }
   }
@@ -191,7 +171,11 @@ export default class FileSystemService {
   static async getAllFilePathsRelative(dirPath: string): Promise<string[]> {
     const filePaths = await this.getAllFilePaths(dirPath);
     return filePaths.map((filePath) => {
-      return filePath.replace(dirPath, '');
+      const relativePath = filePath.replace(dirPath, '');
+      // Remove leading path separator if present
+      return relativePath.startsWith('/') || relativePath.startsWith('\\')
+        ? relativePath.slice(1)
+        : relativePath;
     });
   }
 
@@ -206,9 +190,7 @@ export default class FileSystemService {
       const { stdout } = await execAsync('git status --porcelain');
       return stdout.trim().length > 0;
     } catch (error) {
-      DR.logger.error(
-        `Failed to check for pending changes: ${ErrorUtils.getErrorString(error)}`
-      );
+      DR.logger.error(`Failed to check for pending changes: ${ErrorUtils.getErrorString(error)}`);
       return false;
     }
   }
@@ -259,6 +241,87 @@ export default class FileSystemService {
     );
   }
 
+  /**
+   * Replaces all occurrences of a string in files within a directory.
+   * Supports glob patterns for including/excluding files and handles URL encoding.
+   *
+   * @param options Configuration object for the replacement operation
+   */
+  static async replaceInFiles(options: ReplaceInFilesOptions): Promise<void> {
+    const {
+      searchString,
+      replaceString,
+      rootPath,
+      includePatterns = ['**/*'],
+      excludePatterns = ['**/node_modules/**', '**/.*/**'],
+      includeUrlEncoded = true,
+      dryRun = false
+    } = options;
+
+    DR.logger.info(`Replacing "${searchString}" with "${replaceString}" in ${rootPath}`);
+
+    if (dryRun) {
+      DR.logger.info('DRY RUN MODE - No files will be modified');
+    }
+
+    const allFiles = await this.getAllFilePaths(rootPath);
+    const filesToProcess = GlobMatchingService.getMatchingFiles(
+      allFiles,
+      rootPath,
+      includePatterns,
+      excludePatterns
+    );
+
+    let processedCount = 0;
+    let modifiedCount = 0;
+
+    for (const filePath of filesToProcess) {
+      try {
+        const content = await readFile(filePath, 'utf8');
+        let hasChanges = false;
+        let updatedContent = content;
+
+        // Replace the main string
+        if (content.includes(searchString)) {
+          updatedContent = updatedContent.replaceAll(searchString, replaceString);
+          hasChanges = true;
+        }
+
+        // Replace URL-encoded version if requested
+        if (includeUrlEncoded) {
+          const encodedSearchString = encodeURIComponent(searchString);
+          const encodedReplaceString = encodeURIComponent(replaceString);
+
+          if (updatedContent.includes(encodedSearchString)) {
+            updatedContent = updatedContent.replaceAll(encodedSearchString, encodedReplaceString);
+            hasChanges = true;
+          }
+        }
+
+        if (hasChanges) {
+          const relativePath = path.relative(rootPath, filePath);
+          DR.logger.info(`${dryRun ? 'Would update' : 'Updating'} ${relativePath}...`);
+
+          if (!dryRun) {
+            await writeFile(filePath, updatedContent, 'utf8');
+          }
+
+          modifiedCount++;
+        }
+
+        processedCount++;
+      } catch (error) {
+        // Skip binary files or files we can't read
+        DR.logger.verbose.info(`Skipping ${filePath}: ${ErrorUtils.getErrorString(error)}`);
+        continue;
+      }
+    }
+
+    DR.logger.info(
+      `${dryRun ? 'Would process' : 'Processed'} ${processedCount} files, ${dryRun ? 'would modify' : 'modified'} ${modifiedCount} files`
+    );
+  }
+
   /**
    * Internal helper method that traverses up the directory tree looking for files.
    *
@@ -309,4 +372,26 @@ export default class FileSystemService {
 
     return results;
   }
+
+  /**
+   * Checks if a file should be ignored based on the provided extensions.
+   * Supports both simple extensions (e.g., '.ts') and multi-part extensions (e.g., '.spec.ts').
+   *
+   * @param filePath the path to the file to check
+   * @param ignoreExtensions array of extensions to ignore
+   */
+  private static shouldIgnoreFile(filePath: string, ignoreExtensions: string[]): boolean {
+    const fileName = path.basename(filePath);
+
+    return ignoreExtensions.some((extension) => {
+      // Handle multi-part extensions like '.spec.ts'
+      if (extension.includes('.', 1)) {
+        return fileName.endsWith(extension);
+      }
+
+      // Handle simple extensions like '.ts'
+      const fileExtension = StringService.getFileNameExtension(filePath);
+      return fileExtension === extension;
+    });
+  }
 }

package/lib/services/FileSystemService/GlobMatchingService.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A service for handling glob-like pattern matching operations.
+ * Supports common glob patterns like **, *, and exact matches.
+ *
+ * Inspired by the isaacs/node-glob library (ISC License)
+ * but simplified for basic use cases.
+ */
+export default class GlobMatchingService {
+    /**
+     * Gets files matching the include patterns while excluding those that match exclude patterns.
+     * Uses simple glob-like matching for common patterns.
+     *
+     * @param allFiles Array of all file paths to filter
+     * @param rootPath The root directory path for computing relative paths
+     * @param includePatterns Array of glob-like patterns to include
+     * @param excludePatterns Array of glob-like patterns to exclude
+     */
+    static getMatchingFiles(allFiles: string[], rootPath: string, includePatterns: string[], excludePatterns: string[]): string[];
+    /**
+     * Simple glob-like pattern matching for common use cases.
+     * Supports:
+     * - ** for any number of directories (globstar)
+     * - * for any characters except path separators
+     * - Exact matches
+     *
+     * @param filePath The file path to test
+     * @param pattern The pattern to match against
+     */
+    static matchesPattern(filePath: string, pattern: string): boolean;
+    /**
+     * Match path segments against pattern segments with support for globstar (**).
+     *
+     * The idea is that each segment doesn't cross path separators. It should
+     * be split by '/' and then matched segment by segment.
+     *
+     * @param pathSegments Array of path segments
+     * @param patternSegments Array of pattern segments
+     */
+    private static matchSegments;
+    /**
+     * Match a single segment with support for * wildcard
+     *
+     * @param pathSegment Single path segment
+     * @param patternSegment Single pattern segment
+     */
+    private static matchSingleSegment;
+}
+//# sourceMappingURL=GlobMatchingService.d.ts.map

package/lib/services/FileSystemService/GlobMatchingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobMatchingService.d.ts","sourceRoot":"","sources":["../../../src/services/FileSystemService/GlobMatchingService.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE;IAcX;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAiBjE;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAuD5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAiBlC"}

package/lib/services/FileSystemService/GlobMatchingService.js

@@ -0,0 +1,129 @@
+import path from 'path';
+/**
+ * A service for handling glob-like pattern matching operations.
+ * Supports common glob patterns like **, *, and exact matches.
+ *
+ * Inspired by the isaacs/node-glob library (ISC License)
+ * but simplified for basic use cases.
+ */
+export default class GlobMatchingService {
+    /**
+     * Gets files matching the include patterns while excluding those that match exclude patterns.
+     * Uses simple glob-like matching for common patterns.
+     *
+     * @param allFiles Array of all file paths to filter
+     * @param rootPath The root directory path for computing relative paths
+     * @param includePatterns Array of glob-like patterns to include
+     * @param excludePatterns Array of glob-like patterns to exclude
+     */
+    static getMatchingFiles(allFiles, rootPath, includePatterns, excludePatterns) {
+        return allFiles.filter((filePath) => {
+            const relativePath = path.relative(rootPath, filePath);
+            // Check if file matches any exclude pattern
+            if (excludePatterns.some((pattern) => this.matchesPattern(relativePath, pattern))) {
+                return false;
+            }
+            // Check if file matches any include pattern
+            return includePatterns.some((pattern) => this.matchesPattern(relativePath, pattern));
+        });
+    }
+    /**
+     * Simple glob-like pattern matching for common use cases.
+     * Supports:
+     * - ** for any number of directories (globstar)
+     * - * for any characters except path separators
+     * - Exact matches
+     *
+     * @param filePath The file path to test
+     * @param pattern The pattern to match against
+     */
+    static matchesPattern(filePath, pattern) {
+        // Normalize path separators to forward slashes
+        const normalizedPath = filePath.replace(/\\/g, '/');
+        const normalizedPattern = pattern.replace(/\\/g, '/');
+        // Handle special case of **/* which should match everything
+        if (normalizedPattern === '**/*') {
+            return true;
+        }
+        // Split into segments for more precise matching
+        const pathSegments = normalizedPath.split('/');
+        const patternSegments = normalizedPattern.split('/');
+        return this.matchSegments(pathSegments, patternSegments);
+    }
+    /**
+     * Match path segments against pattern segments with support for globstar (**).
+     *
+     * The idea is that each segment doesn't cross path separators. It should
+     * be split by '/' and then matched segment by segment.
+     *
+     * @param pathSegments Array of path segments
+     * @param patternSegments Array of pattern segments
+     */
+    static matchSegments(pathSegments, patternSegments) {
+        let pathIndex = 0;
+        let patternIndex = 0;
+        while (pathIndex < pathSegments.length && patternIndex < patternSegments.length) {
+            const pathSegment = pathSegments[pathIndex];
+            const patternSegment = patternSegments[patternIndex];
+            if (patternSegment === '**') {
+                // Handle globstar - it can match zero or more segments
+                patternIndex++;
+                // If ** is the last segment, it matches everything remaining
+                if (patternIndex >= patternSegments.length) {
+                    return true;
+                }
+                // Try to match the rest of the pattern against remaining path segments
+                const remainingPattern = patternSegments.slice(patternIndex);
+                // Try matching from current position onwards
+                for (let i = pathIndex; i <= pathSegments.length; i++) {
+                    const remainingPath = pathSegments.slice(i);
+                    if (this.matchSegments(remainingPath, remainingPattern)) {
+                        return true;
+                    }
+                }
+                return false;
+            }
+            else if (this.matchSingleSegment(pathSegment, patternSegment)) {
+                // Regular segment match
+                pathIndex++;
+                patternIndex++;
+            }
+            else {
+                return false;
+            }
+        }
+        // Check if we've consumed both path and pattern completely
+        // or if remaining pattern segments are only globstars
+        const remainingPattern = patternSegments.slice(patternIndex);
+        const pathConsumed = pathIndex >= pathSegments.length;
+        const patternConsumed = patternIndex >= patternSegments.length;
+        if (pathConsumed && patternConsumed) {
+            return true;
+        }
+        if (pathConsumed && remainingPattern.every((seg) => seg === '**')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Match a single segment with support for * wildcard
+     *
+     * @param pathSegment Single path segment
+     * @param patternSegment Single pattern segment
+     */
+    static matchSingleSegment(pathSegment, patternSegment) {
+        if (patternSegment === '*') {
+            return true;
+        }
+        if (patternSegment === pathSegment) {
+            return true;
+        }
+        // Convert pattern to regex for more complex matching
+        const regexPattern = patternSegment
+            .replace(/\./g, '\\.') // Escape dots
+            .replace(/\*/g, '[^/]*'); // * matches anything except slashes
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(pathSegment);
+    }
+}
+//# sourceMappingURL=GlobMatchingService.js.map

package/lib/services/FileSystemService/GlobMatchingService.js.map

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