chore(image): optionally add prefix on loadMedia to avoid naming conflicts

Author: singerla

__tests__/add-external-image.test.ts

@@ -14,6 +14,7 @@ test('Load external media, add/modify image and set image target', async () => {
   const pres = automizer
     .loadRoot(`RootTemplate.pptx`)
     .loadMedia([`feather.png`, `test.png`])
+    .loadMedia(`test.png`, `${__dirname}/../__tests__/media`, 'pre_')
     .load(`SlideWithShapes.pptx`, 'shapes')
     .load(`SlideWithImages.pptx`, 'images');
 
@@ -29,7 +30,7 @@ test('Load external media, add/modify image and set image target', async () => {
 
   pres.addSlide('images', 1, (slide) => {
     slide.modifyElement('Grafik 5', [
-      ModifyImageHelper.setRelationTarget('test.png'),
+      ModifyImageHelper.setRelationTarget('pre_test.png'),
     ]);
   });
 

src/automizer.ts

@@ -205,7 +205,11 @@ export default class Automizer implements IPresentationProps {
    * @param filename Filename or path to the media file.
    * @param dir Specify custom path for media instead of mediaDir from AutomizerParams.
    */
-  public loadMedia(filename: string | string[], dir?: string): this {
+  public loadMedia(
+    filename: string | string[],
+    dir?: string,
+    prefix?: string,
+  ): this {
     const files = GeneralHelper.arrayify(filename);
     if (!this.rootTemplate) {
       throw "Can't load media, you need to load a root template first";
@@ -226,6 +230,7 @@ export default class Automizer implements IPresentationProps {
         directory,
         filepath,
         extension,
+        prefix,
       });
     });
     return this;
@@ -482,8 +487,12 @@ export default class Automizer implements IPresentationProps {
    */
   public async writeMediaFiles(): Promise<void> {
     for (const file of this.rootTemplate.mediaFiles) {
-      const archiveFilename = 'ppt/media/' + file.file;
       const data = fs.readFileSync(file.filepath);
+      let archiveFilename = 'ppt/media/' + file.file;
+      if (file.prefix) {
+        archiveFilename = 'ppt/media/' + file.prefix + file.file;
+      }
+
       await this.rootTemplate.archive.write(archiveFilename, data);
       await XmlHelper.appendImageExtensionToContentType(
         this.rootTemplate.archive,

src/types/types.ts

@@ -154,6 +154,7 @@ export type MediaFile = {
   file: string;
   directory: string;
   filepath: string;
+  prefix?: string;
   extension: ContentTypeExtension;
 };
 export type TrackedFiles = Record<string, string[]>;