@strapi/data-transfer 4.25.17 → 4.25.19

package/dist/index.mjs

@@ -21,7 +21,7 @@ import tar$1 from "tar-stream";
 import { stringer } from "stream-json/jsonl/Stringer";
 import { Option, InvalidOptionArgumentError } from "commander";
 import Table from "cli-table3";
-import { createLogger, configs } from "@strapi/logger";
+import { createLogger, configs, formats } from "@strapi/logger";
 import strapiFactory from "@strapi/strapi";
 import ora from "ora";
 import inquirer from "inquirer";
@@ -579,7 +579,7 @@ class TransferEngine {
   reportInfo(message, params) {
     this.diagnostics.report({
       kind: "info",
-      details: { createdAt: /* @__PURE__ */ new Date(), message, params }
+      details: { createdAt: /* @__PURE__ */ new Date(), message, params, origin: "engine" }
     });
   }
   /**
@@ -871,8 +871,8 @@ ${formattedDiffs}`,
    */
   async bootstrap() {
     const results = await Promise.allSettled([
-      this.sourceProvider.bootstrap?.(),
-      this.destinationProvider.bootstrap?.()
+      this.sourceProvider.bootstrap?.(this.diagnostics),
+      this.destinationProvider.bootstrap?.(this.diagnostics)
     ]);
     results.forEach((result) => {
       if (result.status === "rejected") {
@@ -1863,6 +1863,7 @@ class LocalStrapiDestinationProvider {
   transaction;
   uploadsBackupDirectoryName;
   onWarning;
+  #diagnostics;
   /**
    * The entities mapper is used to map old entities to their new IDs
    */
@@ -1872,7 +1873,8 @@ class LocalStrapiDestinationProvider {
     this.#entitiesMapper = {};
     this.uploadsBackupDirectoryName = `uploads_backup_${Date.now()}`;
   }
-  async bootstrap() {
+  async bootstrap(diagnostics) {
+    this.#diagnostics = diagnostics;
     this.#validateOptions();
     this.strapi = await this.options.getStrapi();
     if (!this.strapi) {
@@ -1889,6 +1891,16 @@ class LocalStrapiDestinationProvider {
     const excluded = this.options.restore?.entities?.exclude && this.options.restore?.entities.exclude.includes(type);
     return !excluded && !notIncluded;
   };
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "local-destination-provider"
+      },
+      kind: "info"
+    });
+  }
   async close() {
     const { autoDestroy } = this.options;
     this.transaction?.end();
@@ -1897,6 +1909,7 @@ class LocalStrapiDestinationProvider {
     }
   }
   #validateOptions() {
+    this.#reportInfo("validating options");
     if (!VALID_CONFLICT_STRATEGIES.includes(this.options.strategy)) {
       throw new ProviderValidationError(`Invalid strategy ${this.options.strategy}`, {
         check: "strategy",
@@ -1913,10 +1926,12 @@ class LocalStrapiDestinationProvider {
     if (!this.options.restore) {
       throw new ProviderValidationError("Missing restore options");
     }
+    this.#reportInfo("deleting record");
     return deleteRecords(this.strapi, this.options.restore);
   }
   async #deleteAllAssets(trx) {
     assertValidStrapi(this.strapi);
+    this.#reportInfo("deleting all assets");
     if (!this.#areAssetsIncluded()) {
       return;
     }
@@ -1929,9 +1944,12 @@ class LocalStrapiDestinationProvider {
         }
       }
     }
+    this.#reportInfo("deleted all assets");
   }
   async rollback() {
+    this.#reportInfo("Rolling back transaction");
     await this.transaction?.rollback();
+    this.#reportInfo("Rolled back transaction");
   }
   async beforeTransfer() {
     if (!this.strapi) {
@@ -1950,6 +1968,7 @@ class LocalStrapiDestinationProvider {
     });
   }
   getMetadata() {
+    this.#reportInfo("getting metadata");
     assertValidStrapi(this.strapi, "Not able to get Schemas");
     const strapiVersion = this.strapi.config.get("info.strapi");
     const createdAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -1961,6 +1980,7 @@ class LocalStrapiDestinationProvider {
     };
   }
   getSchemas() {
+    this.#reportInfo("getting schema");
     assertValidStrapi(this.strapi, "Not able to get Schemas");
     const schemas = {
       ...this.strapi.contentTypes,
@@ -1970,6 +1990,7 @@ class LocalStrapiDestinationProvider {
   }
   createEntitiesWriteStream() {
     assertValidStrapi(this.strapi, "Not able to import entities");
+    this.#reportInfo("creating entities stream");
     const { strategy } = this.options;
     const updateMappingTable = (type, oldID, newID) => {
       if (!this.#entitiesMapper[type]) {
@@ -1996,6 +2017,7 @@ class LocalStrapiDestinationProvider {
       return;
     }
     if (this.strapi.config.get("plugin.upload").provider === "local") {
+      this.#reportInfo("creating assets backup directory");
       const assetsDirectory = path.join(this.strapi.dirs.static.public, "uploads");
       const backupDirectory = path.join(
         this.strapi.dirs.static.public,
@@ -2011,6 +2033,7 @@ class LocalStrapiDestinationProvider {
         await fse.move(assetsDirectory, backupDirectory);
         await fse.mkdir(assetsDirectory);
         await fse.outputFile(path.join(assetsDirectory, ".gitkeep"), "");
+        this.#reportInfo(`created assets backup directory ${backupDirectory}`);
       } catch (err) {
         throw new ProviderTransferError(
           "The backup folder for the assets could not be created inside the public folder. Please ensure Strapi has write permissions on the public directory",
@@ -2028,17 +2051,20 @@ class LocalStrapiDestinationProvider {
       return;
     }
     if (this.strapi.config.get("plugin.upload").provider === "local") {
+      this.#reportInfo("removing assets backup");
       assertValidStrapi(this.strapi);
       const backupDirectory = path.join(
         this.strapi.dirs.static.public,
         this.uploadsBackupDirectoryName
       );
       await fse.rm(backupDirectory, { recursive: true, force: true });
+      this.#reportInfo("successfully removed assets backup");
     }
   }
   // TODO: Move this logic to the restore strategy
   async createAssetsWriteStream() {
     assertValidStrapi(this.strapi, "Not able to stream Assets");
+    this.#reportInfo("creating assets write stream");
     if (!this.#areAssetsIncluded()) {
       throw new ProviderTransferError(
         "Attempting to transfer assets when `assets` is not set in restore options"
@@ -2133,6 +2159,7 @@ class LocalStrapiDestinationProvider {
   }
   async createConfigurationWriteStream() {
     assertValidStrapi(this.strapi, "Not able to stream Configurations");
+    this.#reportInfo("creating configuration write stream");
     const { strategy } = this.options;
     if (strategy === "restore") {
       return createConfigurationWriteStream(this.strapi, this.transaction);
@@ -2144,6 +2171,7 @@ class LocalStrapiDestinationProvider {
     });
   }
   async createLinksWriteStream() {
+    this.#reportInfo("creating links write stream");
     if (!this.strapi) {
       throw new Error("Not able to stream links. Strapi instance not found");
     }
@@ -2344,12 +2372,24 @@ class LocalStrapiSourceProvider {
   type = "source";
   options;
   strapi;
+  #diagnostics;
   constructor(options) {
     this.options = options;
   }
-  async bootstrap() {
+  async bootstrap(diagnostics) {
+    this.#diagnostics = diagnostics;
     this.strapi = await this.options.getStrapi();
   }
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "local-source-provider"
+      },
+      kind: "info"
+    });
+  }
   async close() {
     const { autoDestroy } = this.options;
     if (autoDestroy === void 0 || autoDestroy === true) {
@@ -2357,6 +2397,7 @@ class LocalStrapiSourceProvider {
     }
   }
   getMetadata() {
+    this.#reportInfo("getting metadata");
     const strapiVersion = strapi.config.get("info.strapi");
     const createdAt = (/* @__PURE__ */ new Date()).toISOString();
     return {
@@ -2368,6 +2409,7 @@ class LocalStrapiSourceProvider {
   }
   async createEntitiesReadStream() {
     assertValidStrapi(this.strapi, "Not able to stream entities");
+    this.#reportInfo("creating entities read stream");
     return chain([
       // Entities stream
       createEntitiesStream(this.strapi),
@@ -2377,14 +2419,17 @@ class LocalStrapiSourceProvider {
   }
   createLinksReadStream() {
     assertValidStrapi(this.strapi, "Not able to stream links");
+    this.#reportInfo("creating links read stream");
     return createLinksStream(this.strapi);
   }
   createConfigurationReadStream() {
     assertValidStrapi(this.strapi, "Not able to stream configuration");
+    this.#reportInfo("creating configuration read stream");
     return createConfigurationStream(this.strapi);
   }
   getSchemas() {
     assertValidStrapi(this.strapi, "Not able to get Schemas");
+    this.#reportInfo("getting schemas");
     const schemas = {
       ...this.strapi.contentTypes,
       ...this.strapi.components
@@ -2396,13 +2441,14 @@ class LocalStrapiSourceProvider {
   }
   createAssetsReadStream() {
     assertValidStrapi(this.strapi, "Not able to stream assets");
+    this.#reportInfo("creating assets read stream");
     return createAssetsStream(this.strapi);
   }
 }
 const createDispatcher = (ws, retryMessageOptions = {
   retryMessageMaxRetries: 5,
   retryMessageTimeout: 3e4
-}) => {
+}, reportInfo) => {
   const state = {};
   const dispatch = async (message, options = {}) => {
     if (!ws) {
@@ -2415,6 +2461,16 @@ const createDispatcher = (ws, retryMessageOptions = {
       if (options.attachTransfer) {
         Object.assign(payload, { transferID: state.transfer?.id });
       }
+      if (message.type === "command") {
+        reportInfo?.(
+          `dispatching message command:${message.command} uuid:${uuid} sent:${numberOfTimesMessageWasSent}`
+        );
+      } else if (message.type === "transfer") {
+        const messageToSend = message;
+        reportInfo?.(
+          `dispatching message action:${messageToSend.action} ${messageToSend.kind === "step" ? `step:${messageToSend.step}` : ""} uuid:${uuid} sent:${numberOfTimesMessageWasSent}`
+        );
+      }
       const stringifiedPayload = JSON.stringify(payload);
       ws.send(stringifiedPayload, (error) => {
         if (error) {
@@ -2437,6 +2493,16 @@ const createDispatcher = (ws, retryMessageOptions = {
       const interval = setInterval(sendPeriodically, retryMessageTimeout);
       const onResponse = (raw) => {
         const response = JSON.parse(raw.toString());
+        if (message.type === "command") {
+          reportInfo?.(
+            `received response to message command: ${message.command} uuid: ${uuid} sent: ${numberOfTimesMessageWasSent}`
+          );
+        } else if (message.type === "transfer") {
+          const messageToSend = message;
+          reportInfo?.(
+            `received response to message action:${messageToSend.action} ${messageToSend.kind === "step" ? `step:${messageToSend.step}` : ""} uuid:${uuid} sent:${numberOfTimesMessageWasSent}`
+          );
+        }
         if (response.uuid === uuid) {
           clearInterval(interval);
           if (response.error) {
@@ -2493,7 +2559,7 @@ const createDispatcher = (ws, retryMessageOptions = {
     dispatchTransferStep
   };
 };
-const connectToWebsocket = (address, options) => {
+const connectToWebsocket = (address, options, diagnostics) => {
   return new Promise((resolve, reject2) => {
     const server = new WebSocket(address, options);
     server.once("open", () => {
@@ -2527,6 +2593,14 @@ const connectToWebsocket = (address, options) => {
         )
       );
     });
+    server.on("message", (raw) => {
+      const response = JSON.parse(raw.toString());
+      if (response.diagnostic) {
+        diagnostics?.report({
+          ...response.diagnostic
+        });
+      }
+    });
     server.once("error", (err) => {
       reject2(
         new ProviderTransferError(err.message, {
@@ -2567,6 +2641,7 @@ class RemoteStrapiDestinationProvider {
   ws;
   dispatcher;
   transferID;
+  #diagnostics;
   constructor(options) {
     this.options = options;
     this.ws = null;
@@ -2665,7 +2740,18 @@ class RemoteStrapiDestinationProvider {
       }
     });
   }
-  async bootstrap() {
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "remote-destination-provider"
+      },
+      kind: "info"
+    });
+  }
+  async bootstrap(diagnostics) {
+    this.#diagnostics = diagnostics;
     const { url, auth } = this.options;
     const validProtocols = ["https:", "http:"];
     let ws;
@@ -2682,6 +2768,7 @@ class RemoteStrapiDestinationProvider {
     const wsUrl = `${wsProtocol}//${url.host}${trimTrailingSlash(
       url.pathname
     )}${TRANSFER_PATH}/push`;
+    this.#reportInfo("establishing websocket connection");
     if (!auth) {
       ws = await connectToWebsocket(wsUrl);
     } else if (auth.type === "token") {
@@ -2695,10 +2782,19 @@ class RemoteStrapiDestinationProvider {
         }
       });
     }
+    this.#reportInfo("established websocket connection");
     this.ws = ws;
     const { retryMessageOptions } = this.options;
-    this.dispatcher = createDispatcher(this.ws, retryMessageOptions);
+    this.#reportInfo("creating dispatcher");
+    this.dispatcher = createDispatcher(
+      this.ws,
+      retryMessageOptions,
+      (message) => this.#reportInfo(message)
+    );
+    this.#reportInfo("created dispatcher");
+    this.#reportInfo("initialize transfer");
     this.transferID = await this.initTransfer();
+    this.#reportInfo(`initialized transfer ${this.transferID}`);
     this.dispatcher.setTransferProperties({ id: this.transferID, kind: "push" });
     await this.dispatcher.dispatchTransferAction("bootstrap");
   }
@@ -2819,6 +2915,7 @@ class RemoteStrapiSourceProvider {
   options;
   ws;
   dispatcher;
+  #diagnostics;
   constructor(options) {
     this.options = options;
     this.ws = null;
@@ -3007,6 +3104,16 @@ class RemoteStrapiSourceProvider {
     }
     return res.transferID;
   }
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "remote-source-provider"
+      },
+      kind: "info"
+    });
+  }
   async bootstrap() {
     const { url, auth } = this.options;
     let ws;
@@ -3015,6 +3122,7 @@ class RemoteStrapiSourceProvider {
     const wsUrl = `${wsProtocol}//${url.host}${trimTrailingSlash(
       url.pathname
     )}${TRANSFER_PATH}/pull`;
+    this.#reportInfo("establishing websocket connection");
     if (!auth) {
       ws = await connectToWebsocket(wsUrl);
     } else if (auth.type === "token") {
@@ -3028,10 +3136,19 @@ class RemoteStrapiSourceProvider {
         }
       });
     }
+    this.#reportInfo("established websocket connection");
     this.ws = ws;
     const { retryMessageOptions } = this.options;
-    this.dispatcher = createDispatcher(this.ws, retryMessageOptions);
+    this.#reportInfo("creating dispatcher");
+    this.dispatcher = createDispatcher(
+      this.ws,
+      retryMessageOptions,
+      (message) => this.#reportInfo(message)
+    );
+    this.#reportInfo("creating dispatcher");
+    this.#reportInfo("initialize transfer");
     const transferID = await this.initTransfer();
+    this.#reportInfo(`initialized transfer ${transferID}`);
     this.dispatcher.setTransferProperties({ id: transferID, kind: "pull" });
     await this.dispatcher.dispatchTransferAction("bootstrap");
   }
@@ -3263,6 +3380,7 @@ const handlerControllerFactory = (implementation) => (options) => {
     const cb = (ws) => {
       const state = { id: void 0 };
       const messageUUIDs = /* @__PURE__ */ new Set();
+      const diagnostics = createDiagnosticReporter();
       const cannotRespondHandler = (err) => {
         strapi?.log?.error(
           "[Data transfer] Cannot send error response to client, closing connection"
@@ -3296,6 +3414,9 @@ const handlerControllerFactory = (implementation) => (options) => {
         set response(response) {
           state.response = response;
         },
+        get diagnostics() {
+          return diagnostics;
+        },
         addUUID(uuid) {
           messageUUIDs.add(uuid);
         },
@@ -3411,6 +3532,10 @@ const handlerControllerFactory = (implementation) => (options) => {
         onError() {
         },
         onClose() {
+        },
+        onInfo() {
+        },
+        onWarning() {
         }
       };
       const handler = Object.assign(Object.create(prototype), implementation(prototype));
@@ -3443,6 +3568,14 @@ const handlerControllerFactory = (implementation) => (options) => {
           cannotRespondHandler(err);
         }
       });
+      diagnostics.onDiagnostic((diagnostic) => {
+        const uuid = randomUUID();
+        const payload = JSON.stringify({
+          diagnostic,
+          uuid
+        });
+        handler.send(payload);
+      });
     };
     try {
       handleWSUpgrade(wss, ctx, cb);
@@ -3478,6 +3611,26 @@ const createPushController = handlerControllerFactory((proto) => ({
   verifyAuth() {
     return proto.verifyAuth.call(this, TRANSFER_KIND$1);
   },
+  onInfo(message) {
+    this.diagnostics?.report({
+      details: {
+        message,
+        origin: "push-handler",
+        createdAt: /* @__PURE__ */ new Date()
+      },
+      kind: "info"
+    });
+  },
+  onWarning(message) {
+    this.diagnostics?.report({
+      details: {
+        message,
+        createdAt: /* @__PURE__ */ new Date(),
+        origin: "push-handler"
+      },
+      kind: "warning"
+    });
+  },
   cleanup() {
     proto.cleanup.call(this);
     this.streams = {};
@@ -3554,6 +3707,7 @@ const createPushController = handlerControllerFactory((proto) => ({
     proto.addUUID(uuid);
     if (type === "command") {
       const { command: command2 } = msg;
+      this.onInfo(`received command:${command2} uuid:${uuid}`);
       await this.executeAndRespond(uuid, () => {
         this.assertValidTransferCommand(command2);
         if (command2 === "status") {
@@ -3562,6 +3716,7 @@ const createPushController = handlerControllerFactory((proto) => ({
         return this[command2](msg.params);
       });
     } else if (type === "transfer") {
+      this.onInfo(`received transfer action:${msg.action} step:${msg.kind} uuid:${uuid}`);
       await this.executeAndRespond(uuid, async () => {
         await this.verifyAuth();
         this.assertValidTransfer();
@@ -3656,6 +3811,9 @@ const createPushController = handlerControllerFactory((proto) => ({
       }
       this.flow?.set(step);
     }
+    if (action2 === "bootstrap") {
+      return this.provider?.[action2](this.diagnostics);
+    }
     return this.provider?.[action2]();
   },
   async streamAsset(payload) {
@@ -3713,6 +3871,7 @@ const createPushController = handlerControllerFactory((proto) => ({
       getStrapi: () => strapi
     });
     this.provider.onWarning = (message) => {
+      this.onWarning(message);
       strapi.log.warn(message);
     };
     return { transferID: this.transferID };
@@ -3753,6 +3912,26 @@ const createPullController = handlerControllerFactory((proto) => ({
     this.streams = {};
     delete this.provider;
   },
+  onInfo(message) {
+    this.diagnostics?.report({
+      details: {
+        message,
+        origin: "pull-handler",
+        createdAt: /* @__PURE__ */ new Date()
+      },
+      kind: "info"
+    });
+  },
+  onWarning(message) {
+    this.diagnostics?.report({
+      details: {
+        message,
+        createdAt: /* @__PURE__ */ new Date(),
+        origin: "pull-handler"
+      },
+      kind: "warning"
+    });
+  },
   assertValidTransferAction(action2) {
     const validActions = VALID_TRANSFER_ACTIONS;
     if (validActions.includes(action2)) {
@@ -3782,6 +3961,7 @@ const createPullController = handlerControllerFactory((proto) => ({
     proto.addUUID(uuid);
     if (type === "command") {
       const { command: command2 } = msg;
+      this.onInfo(`received command:${command2} uuid:${uuid}`);
       await this.executeAndRespond(uuid, () => {
         this.assertValidTransferCommand(command2);
         if (command2 === "status") {
@@ -3790,6 +3970,7 @@ const createPullController = handlerControllerFactory((proto) => ({
         return this[command2](msg.params);
       });
     } else if (type === "transfer") {
+      this.onInfo(`received transfer action:${msg.action} step:${msg.kind} uuid:${uuid}`);
       await this.executeAndRespond(uuid, async () => {
         await this.verifyAuth();
         this.assertValidTransfer();
@@ -3811,6 +3992,9 @@ const createPullController = handlerControllerFactory((proto) => ({
   async onTransferAction(msg) {
     const { action: action2 } = msg;
     this.assertValidTransferAction(action2);
+    if (action2 === "bootstrap") {
+      return this.provider?.[action2](this.diagnostics);
+    }
     return this.provider?.[action2]();
   },
   async flush(stage, id) {
@@ -4009,6 +4193,7 @@ class LocalFileSourceProvider {
   name = "source::local-file";
   options;
   #metadata;
+  #diagnostics;
   constructor(options) {
     this.options = options;
     const { encryption } = this.options;
@@ -4016,6 +4201,16 @@ class LocalFileSourceProvider {
       throw new Error("Missing encryption key");
     }
   }
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "file-source-provider"
+      },
+      kind: "info"
+    });
+  }
   /**
    * Pre flight checks regarding the provided options, making sure that the file can be opened (decrypted, decompressed), etc.
    */
@@ -4044,12 +4239,14 @@ class LocalFileSourceProvider {
     return this.#parseJSONFile(backupStream, path2);
   }
   async getMetadata() {
+    this.#reportInfo("getting metadata");
     if (!this.#metadata) {
       await this.#loadMetadata();
     }
     return this.#metadata ?? null;
   }
   async getSchemas() {
+    this.#reportInfo("getting schemas");
     const schemas = await collect(this.createSchemasReadStream());
     if (isEmpty(schemas)) {
       throw new ProviderInitializationError("Could not load schemas from Strapi data file.");
@@ -4057,21 +4254,26 @@ class LocalFileSourceProvider {
     return keyBy("uid", schemas);
   }
   createEntitiesReadStream() {
+    this.#reportInfo("creating entities read stream");
     return this.#streamJsonlDirectory("entities");
   }
   createSchemasReadStream() {
+    this.#reportInfo("creating schemas read stream");
     return this.#streamJsonlDirectory("schemas");
   }
   createLinksReadStream() {
+    this.#reportInfo("creating links read stream");
     return this.#streamJsonlDirectory("links");
   }
   createConfigurationReadStream() {
+    this.#reportInfo("creating configuration read stream");
     return this.#streamJsonlDirectory("configuration");
   }
   createAssetsReadStream() {
     const inStream = this.#getBackupStream();
     const outStream = new PassThrough({ objectMode: true });
     const loadAssetMetadata = this.#loadAssetMetadata.bind(this);
+    this.#reportInfo("creating assets read stream");
     pipeline(
       [
         inStream,
@@ -4272,9 +4474,20 @@ class LocalFileDestinationProvider {
   results = {};
   #providersMetadata = {};
   #archive = {};
+  #diagnostics;
   constructor(options) {
     this.options = options;
   }
+  #reportInfo(message) {
+    this.#diagnostics?.report({
+      details: {
+        createdAt: /* @__PURE__ */ new Date(),
+        message,
+        origin: "file-destination-provider"
+      },
+      kind: "info"
+    });
+  }
   get #archivePath() {
     const { encryption, compression, file: file2 } = this.options;
     let filePath = `${file2.path}.tar`;
@@ -4291,9 +4504,11 @@ class LocalFileDestinationProvider {
     return this;
   }
   createGzip() {
+    this.#reportInfo("creating gzip");
     return zip$1.createGzip();
   }
-  bootstrap() {
+  bootstrap(diagnostics) {
+    this.#diagnostics = diagnostics;
     const { compression, encryption } = this.options;
     if (encryption.enabled && !encryption.key) {
       throw new Error("Can't encrypt without a key");
@@ -4332,6 +4547,7 @@ class LocalFileDestinationProvider {
     }
   }
   async rollback() {
+    this.#reportInfo("rolling back");
     await this.close();
     await rm(this.#archivePath, { force: true });
   }
@@ -4339,6 +4555,7 @@ class LocalFileDestinationProvider {
     return null;
   }
   async #writeMetadata() {
+    this.#reportInfo("writing metadata");
     const metadata = this.#providersMetadata.source;
     if (metadata) {
       await new Promise((resolve) => {
@@ -4359,6 +4576,7 @@ class LocalFileDestinationProvider {
     if (!this.#archive.stream) {
       throw new Error("Archive stream is unavailable");
     }
+    this.#reportInfo("creating schemas write stream");
     const filePathFactory = createFilePathFactory("schemas");
     const entryStream = createTarEntryStream(
       this.#archive.stream,
@@ -4371,6 +4589,7 @@ class LocalFileDestinationProvider {
     if (!this.#archive.stream) {
       throw new Error("Archive stream is unavailable");
     }
+    this.#reportInfo("creating entities write stream");
     const filePathFactory = createFilePathFactory("entities");
     const entryStream = createTarEntryStream(
       this.#archive.stream,
@@ -4383,6 +4602,7 @@ class LocalFileDestinationProvider {
     if (!this.#archive.stream) {
       throw new Error("Archive stream is unavailable");
     }
+    this.#reportInfo("creating links write stream");
     const filePathFactory = createFilePathFactory("links");
     const entryStream = createTarEntryStream(
       this.#archive.stream,
@@ -4395,6 +4615,7 @@ class LocalFileDestinationProvider {
     if (!this.#archive.stream) {
       throw new Error("Archive stream is unavailable");
     }
+    this.#reportInfo("creating configuration write stream");
     const filePathFactory = createFilePathFactory("configuration");
     const entryStream = createTarEntryStream(
       this.#archive.stream,
@@ -4408,6 +4629,7 @@ class LocalFileDestinationProvider {
     if (!archiveStream) {
       throw new Error("Archive stream is unavailable");
     }
+    this.#reportInfo("creating assets write stream");
     return new Writable({
       objectMode: true,
       write(data, _encoding, callback) {
@@ -4743,30 +4965,41 @@ const errorColors = {
   error: chalk.red,
   silly: chalk.yellow
 };
-const formatDiagnostic = (operation) => ({ details, kind }) => {
-  const logger = createLogger(
-    configs.createOutputFileConfiguration(`${operation}_error_log_${Date.now()}.log`)
-  );
-  try {
-    if (kind === "error") {
-      const { message, severity = "fatal" } = details;
-      const colorizeError = errorColors[severity];
-      const errorMessage = colorizeError(`[${severity.toUpperCase()}] ${message}`);
-      logger.error(errorMessage);
-    }
-    if (kind === "info") {
-      const { message, params } = details;
-      const msg = `${message}
-${params ? JSON.stringify(params, null, 2) : ""}`;
-      logger.info(msg);
+const formatDiagnostic = (operation, info) => {
+  let logger;
+  const getLogger = () => {
+    if (!logger) {
+      logger = createLogger(
+        configs.createOutputFileConfiguration(`${operation}_${Date.now()}.log`, {
+          level: "info",
+          format: formats?.detailedLogs
+        })
+      );
     }
-    if (kind === "warning") {
-      const { origin: origin2, message } = details;
-      logger.warn(`(${origin2 ?? "transfer"}) ${message}`);
+    return logger;
+  };
+  return ({ details, kind }) => {
+    try {
+      if (kind === "error") {
+        const { message, severity = "fatal" } = details;
+        const colorizeError = errorColors[severity];
+        const errorMessage = colorizeError(`[${severity.toUpperCase()}] ${message}`);
+        getLogger().error(errorMessage);
+      }
+      if (kind === "info" && info) {
+        const { message, params, origin: origin2 } = details;
+        const msg = `[${origin2 ?? "transfer"}] ${message}
+${params ? JSON.stringify(params, null, 2) : ""}`;
+        getLogger().info(msg);
+      }
+      if (kind === "warning") {
+        const { origin: origin2, message } = details;
+        getLogger().warn(`(${origin2 ?? "transfer"}) ${message}`);
+      }
+    } catch (err) {
+      getLogger().error(err);
     }
-  } catch (err) {
-    logger.error(err);
-  }
+  };
 };
 const loadersFactory = (defaultLoaders = {}) => {
   const loaders = defaultLoaders;
@@ -4948,7 +5181,7 @@ const action$2 = async (opts) => {
       ]
     }
   });
-  engine.diagnostics.onDiagnostic(formatDiagnostic("export"));
+  engine.diagnostics.onDiagnostic(formatDiagnostic("export", opts.verbose));
   const progress = engine.progress.stream;
   const { updateLoader } = loadersFactory();
   progress.on(`stage::start`, ({ stage, data }) => {
@@ -5020,7 +5253,7 @@ const command$2 = ({ command: command2 }) => {
     )
   ).addOption(
     new Option("--no-compress", "Disables gzip compression of output file").default(true)
-  ).addOption(
+  ).addOption(new Option("--verbose", "Enable verbose logs")).addOption(
     new Option(
       "-k, --key <string>",
       "Provide encryption key in command instead of using the prompt"
@@ -5076,7 +5309,7 @@ const action$1 = async (opts) => {
   destination.onWarning = (message) => console.warn(`
 ${chalk.yellow("warn")}: ${message}`);
   const engine2 = createTransferEngine$1(source, destination, engineOptions);
-  engine2.diagnostics.onDiagnostic(formatDiagnostic("import"));
+  engine2.diagnostics.onDiagnostic(formatDiagnostic("import", opts.verbose));
   const progress = engine2.progress.stream;
   const { updateLoader } = loadersFactory();
   engine2.onSchemaDiff(getDiffHandler(engine2, { force: opts.force, action: "import" }));
@@ -5134,7 +5367,7 @@ const command$1 = ({ command: command2 }) => {
       "-k, --key <string>",
       "Provide encryption key in command instead of using the prompt"
     )
-  ).addOption(forceOption).addOption(excludeOption).addOption(onlyOption).addOption(throttleOption).hook("preAction", validateExcludeOnly).hook("preAction", async (thisCommand) => {
+  ).addOption(new Option("--verbose", "Enable verbose logs")).addOption(forceOption).addOption(excludeOption).addOption(onlyOption).addOption(throttleOption).hook("preAction", validateExcludeOnly).hook("preAction", async (thisCommand) => {
     const opts = thisCommand.opts();
     const ext = path.extname(String(opts.file));
     if (ext === ".enc") {
@@ -5264,7 +5497,7 @@ const action = async (opts) => {
       ]
     }
   });
-  engine.diagnostics.onDiagnostic(formatDiagnostic("transfer"));
+  engine.diagnostics.onDiagnostic(formatDiagnostic("transfer", opts.verbose));
   const progress = engine.progress.stream;
   const { updateLoader } = loadersFactory();
   engine.onSchemaDiff(getDiffHandler(engine, { force: opts.force, action: "transfer" }));
@@ -5316,7 +5549,7 @@ const command = ({ command: command2 }) => {
       "--to <destinationURL>",
       `URL of the remote Strapi instance to send data to`
     ).argParser(parseURL)
-  ).addOption(new Option("--to-token <token>", `Transfer token for the remote Strapi destination`)).addOption(forceOption).addOption(excludeOption).addOption(onlyOption).addOption(throttleOption).hook("preAction", validateExcludeOnly).hook(
+  ).addOption(new Option("--to-token <token>", `Transfer token for the remote Strapi destination`)).addOption(new Option("--verbose", "Enable verbose logs")).addOption(forceOption).addOption(excludeOption).addOption(onlyOption).addOption(throttleOption).hook("preAction", validateExcludeOnly).hook(
     "preAction",
     ifOptions(
       (opts) => !(opts.from || opts.to) || opts.from && opts.to,