@wlindabla/file_uploader 1.0.0

package/dist/exceptions/index.js

@@ -0,0 +1,133 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class InitializeUploadFailureException extends Error {
+  constructor(responseData, message) {
+    super(message);
+    this.responseData = responseData;
+    this.name = "InitializeUploadFailureException";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, InitializeUploadFailureException);
+    }
+  }
+  static {
+    __name(this, "InitializeUploadFailureException");
+  }
+}
+class ChunkUploadHttpErrorException extends Error {
+  constructor(errorPayload, statusResponse) {
+    super();
+    this.errorPayload = errorPayload;
+    this.statusResponse = statusResponse;
+    this.name = "ChunkUploadHttpErrorException";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ChunkUploadHttpErrorException);
+    }
+  }
+  static {
+    __name(this, "ChunkUploadHttpErrorException");
+  }
+}
+class FileUploadChunkError extends Error {
+  static {
+    __name(this, "FileUploadChunkError");
+  }
+  /**
+   * The detailed chunk error information
+   */
+  chunkError;
+  /**
+   * Creates a new FileUploadChunkError
+   * 
+   * @param message - Human-readable error message
+   * @param chunkError - Detailed information about the chunk failure
+   */
+  constructor(message, chunkError) {
+    super(message, { cause: chunkError.error });
+    this.name = "FileUploadChunkError";
+    this.chunkError = chunkError;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, FileUploadChunkError);
+    }
+  }
+  /**
+   * Gets the index of the chunk that failed
+   */
+  get chunkIndex() {
+    return this.chunkError.chunk.index;
+  }
+  /**
+   * Gets the attempt number when the chunk failed
+   */
+  get attemptNumber() {
+    return this.chunkError.attempt;
+  }
+  /**
+   * Indicates whether a retry will be attempted
+   */
+  get willRetry() {
+    return this.chunkError.willRetry;
+  }
+  /**
+   * Gets the underlying error that caused the chunk upload to fail
+   */
+  get underlyingError() {
+    return this.chunkError.error;
+  }
+  /**
+   * Gets the full chunk information
+   */
+  get chunk() {
+    return this.chunkError.chunk;
+  }
+  /**
+   * Returns a detailed string representation of the error
+   */
+  toString() {
+    return `${this.name}: ${this.message}
+  Chunk: ${this.chunkIndex + 1}/${this.chunk.size} bytes
+  Attempt: ${this.attemptNumber}
+  Will Retry: ${this.willRetry}
+  Cause: ${this.underlyingError.message}`;
+  }
+  /**
+   * Returns a JSON representation of the error
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      chunkIndex: this.chunkIndex,
+      attempt: this.attemptNumber,
+      willRetry: this.willRetry,
+      underlyingError: {
+        name: this.underlyingError.name,
+        message: this.underlyingError.message
+      },
+      stack: this.stack
+    };
+  }
+}
+class UploadCancelledException extends Error {
+  constructor(chunkIndex, totalChunks, uploadedBytes, message) {
+    super(message);
+    this.chunkIndex = chunkIndex;
+    this.totalChunks = totalChunks;
+    this.uploadedBytes = uploadedBytes;
+    this.name = "UploadCancelledException";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, UploadCancelledException);
+    }
+  }
+  static {
+    __name(this, "UploadCancelledException");
+  }
+}
+
+exports.ChunkUploadHttpErrorException = ChunkUploadHttpErrorException;
+exports.FileUploadChunkError = FileUploadChunkError;
+exports.InitializeUploadFailureException = InitializeUploadFailureException;
+exports.UploadCancelledException = UploadCancelledException;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\n * This file is part of the project by AGBOKOUDJO Franck.\n *\n * (c) AGBOKOUDJO Franck <internationaleswebservices@gmail.com>\n * Phone: +229 0167 25 18 86\n * LinkedIn: https://www.linkedin.com/in/internationales-web-apps-services-120520193/\n * Company: INTERNATIONALES WEB APPS & SERVICES\n *\n * For more information, please feel free to contact the author.\n */\n\nimport { ChunkInfo, ChunkError } from \"../types\";\n\nexport class InitializeUploadFailureException extends Error {\n    constructor(public readonly responseData: any, message: string) {\n        super(message);\n        this.name = \"InitializeUploadFailureException\";\n\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, InitializeUploadFailureException);\n        }\n    }\n}\n\n/**\n * Exception data for MEDIA_CHUNK_UPLOAD_HTTP_ERROR_RESPONSE\n */\nexport class ChunkUploadHttpErrorException extends Error {\n    constructor(\n        public readonly errorPayload: string | Record<string, string | unknown> | unknown,\n        public readonly statusResponse: number\n    ) {\n        super();\n\n        this.name = \"ChunkUploadHttpErrorException\";\n\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, ChunkUploadHttpErrorException);\n        }\n    }\n}\n\n/**\n * Custom error thrown during chunked file upload operations.\n * \n * This error provides detailed information about which chunk failed,\n * the underlying error, and whether a retry will be attempted.\n * \n * @example\n * ```typescript\n * try {\n *   await uploadChunk(chunk);\n * } catch (error) {\n *   throw new FileUploadChunkError(\n *     `Failed to upload chunk ${chunkIndex}`,\n *     chunkError\n *   );\n * }\n * \n * // Later in error handler\n * if (error instanceof FileUploadChunkError) {\n *   console.log(`Chunk ${error.chunkIndex} failed`);\n *   console.log(`Will retry: ${error.willRetry}`);\n * }\n * ```\n */\nexport class FileUploadChunkError extends Error {\n\n    /**\n     * The detailed chunk error information\n     */\n    public readonly chunkError: ChunkError;\n\n    /**\n     * Creates a new FileUploadChunkError\n     * \n     * @param message - Human-readable error message\n     * @param chunkError - Detailed information about the chunk failure\n     */\n    constructor(message: string, chunkError: ChunkError) {\n        super(message, { cause: chunkError.error });\n\n        this.name = \"FileUploadChunkError\";\n        this.chunkError = chunkError;\n\n        // Maintain proper stack trace in V8 engines (Chrome, Node.js)\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, FileUploadChunkError);\n        }\n    }\n\n    /**\n     * Gets the index of the chunk that failed\n     */\n    get chunkIndex(): number {\n        return this.chunkError.chunk.index;\n    }\n\n    /**\n     * Gets the attempt number when the chunk failed\n     */\n    get attemptNumber(): number {\n        return this.chunkError.attempt;\n    }\n\n    /**\n     * Indicates whether a retry will be attempted\n     */\n    get willRetry(): boolean {\n        return this.chunkError.willRetry;\n    }\n\n    /**\n     * Gets the underlying error that caused the chunk upload to fail\n     */\n    get underlyingError(): Error {\n        return this.chunkError.error;\n    }\n\n    /**\n     * Gets the full chunk information\n     */\n    get chunk(): ChunkInfo {\n        return this.chunkError.chunk;\n    }\n\n    /**\n     * Returns a detailed string representation of the error\n     */\n    toString(): string {\n        return `${this.name}: ${this.message}\\n` +\n            `  Chunk: ${this.chunkIndex + 1}/${this.chunk.size} bytes\\n` +\n            `  Attempt: ${this.attemptNumber}\\n` +\n            `  Will Retry: ${this.willRetry}\\n` +\n            `  Cause: ${this.underlyingError.message}`;\n    }\n\n    /**\n     * Returns a JSON representation of the error\n     */\n    toJSON(): object {\n        return {\n            name: this.name,\n            message: this.message,\n            chunkIndex: this.chunkIndex,\n            attempt: this.attemptNumber,\n            willRetry: this.willRetry,\n            underlyingError: {\n                name: this.underlyingError.name,\n                message: this.underlyingError.message\n            },\n            stack: this.stack\n        };\n    }\n}\n\n\nexport class UploadCancelledException extends Error {\n    constructor(\n        public readonly chunkIndex: number,\n        public readonly totalChunks: number,\n        public readonly uploadedBytes: number,\n        message: string\n    ) {\n        super(message);\n        this.name = \"UploadCancelledException\";\n\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, UploadCancelledException);\n        }\n    }\n}"]}

package/dist/index.js

@@ -0,0 +1,49 @@
+'use strict';
+
+var utils = require('./utils');
+var exceptions = require('./exceptions');
+var events = require('./events');
+var subscribers = require('./subscribers');
+var cache = require('./cache');
+var core = require('./core');
+
+
+
+Object.keys(utils).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return utils[k]; }
+	});
+});
+Object.keys(exceptions).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return exceptions[k]; }
+	});
+});
+Object.keys(events).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return events[k]; }
+	});
+});
+Object.keys(subscribers).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return subscribers[k]; }
+	});
+});
+Object.keys(cache).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return cache[k]; }
+	});
+});
+Object.keys(core).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return core[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/subscribers/index.js

@@ -0,0 +1,162 @@
+'use strict';
+
+var events = require('../events');
+var http_client = require('@wlindabla/http_client');
+var exceptions = require('../exceptions');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class InitializeUploadSubscriber {
+  constructor(eventDispatcher) {
+    this.eventDispatcher = eventDispatcher;
+  }
+  static {
+    __name(this, "InitializeUploadSubscriber");
+  }
+  getSubscribedEvents() {
+    return {
+      [events.HttpFileUploaderEvents.INITIALIZE_UPLOAD]: { listener: "onInitializeUpload", priority: 100 }
+    };
+  }
+  /**
+  * Initializes upload session with the server.
+  * 
+  * @param fileHash - SHA-256 hash of the file (first 1MB)
+  * @returns Session ID from server, or null if initialization failed
+  * @throws {FileUploadInitializationError} If server returns error or network fails
+  */
+  async onInitializeUpload(event) {
+    event.stopPropagation();
+    const initialzeUploadRequestOptions = event.initUploadOptions;
+    this.eventDispatcher.dispatch(
+      new events.InitializeUploadStartedEvent(
+        initialzeUploadRequestOptions.fileName,
+        initialzeUploadRequestOptions.fileSize,
+        initialzeUploadRequestOptions.fileHash
+      ),
+      events.HttpFileUploaderEvents.INITIALIZE_UPLOAD_STARTED
+    );
+    try {
+      const response = await http_client.safeFetch({
+        url: initialzeUploadRequestOptions.endpointInit,
+        methodSend: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...initialzeUploadRequestOptions.headers
+        },
+        data: {
+          fileName: initialzeUploadRequestOptions.fileName,
+          fileSize: initialzeUploadRequestOptions.fileSize,
+          fileHash: initialzeUploadRequestOptions.fileHash,
+          fileType: initialzeUploadRequestOptions.fileType,
+          metadata: initialzeUploadRequestOptions.metadata
+        },
+        responseType: "json",
+        retryCount: 3,
+        retryOnStatusCode: true,
+        timeout: 45e3
+      });
+      const status = response.status;
+      if (response.failed) {
+        console.error(`Initialize upload failed (HTTP ${status}):`, response);
+        const errorUploadFailure = new exceptions.InitializeUploadFailureException(
+          response,
+          `Server returned error: HTTP ${response.status}`
+        );
+        this.eventDispatcher.dispatch(
+          new events.InitializeUploadFailureEvent(
+            errorUploadFailure,
+            status,
+            response.data
+          ),
+          events.HttpFileUploaderEvents.INITIALIZE_UPLOAD_FAILURE
+        );
+        throw errorUploadFailure;
+      }
+      const responseData = response.data;
+      if (!responseData || typeof responseData !== "object") {
+        const validationError = "Invalid server response: expected object, got " + typeof responseData;
+        console.error("Invalid response structure:", responseData);
+        throw new exceptions.InitializeUploadFailureException(
+          responseData,
+          validationError
+        );
+      }
+      let sessionId = responseData.mediaId || responseData.mediaIdFromServer || responseData.sessionId || responseData.uploadId;
+      if (!sessionId) {
+        const missingKeyError = 'Server response missing required field: "mediaId","mediaIdFromServer", "sessionId", or "uploadId"';
+        console.error("Missing session ID in response:", responseData);
+        throw new exceptions.InitializeUploadFailureException(
+          responseData,
+          missingKeyError
+        );
+      }
+      if (typeof sessionId === "number") {
+        sessionId = sessionId.toString();
+      }
+      event.setMediaId(sessionId);
+      this.eventDispatcher.dispatch(
+        new events.InitializeUploadSuccessEvent(
+          status,
+          sessionId,
+          responseData
+        ),
+        events.HttpFileUploaderEvents.INITIALIZE_UPLOAD_SUCCESS
+      );
+    } catch (error) {
+      if (error instanceof http_client.HttpFetchError) {
+        this.eventDispatcher.dispatch(
+          new events.InitializeUploadFailureEvent(
+            error instanceof Error ? error : new Error(String(error))
+          ),
+          events.HttpFileUploaderEvents.INITIALIZE_UPLOAD_FAILURE
+        );
+        return;
+      }
+      console.error("Initialize upload exception:", error);
+      throw error;
+    }
+  }
+}
+class FinalizeUploadSubscriber {
+  constructor(eventDispatcher) {
+    this.eventDispatcher = eventDispatcher;
+  }
+  static {
+    __name(this, "FinalizeUploadSubscriber");
+  }
+  getSubscribedEvents() {
+    return {
+      [events.HttpFileUploaderEvents.FINALIZE_UPLOAD]: { listener: "onFinalizeUpload", priority: 100 }
+    };
+  }
+  async onFinalizeUpload(event) {
+    event.stopPropagation();
+    try {
+      const responseFinalizeUpload = await http_client.safeFetch({
+        url: event.endPoint,
+        methodSend: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...event.headers
+        },
+        data: { mediaId: event.mediaId, mediaHash: event.mediaHash }
+      });
+      event.setResponse(responseFinalizeUpload);
+    } catch (error) {
+      if (error instanceof http_client.HttpFetchError) {
+        this.eventDispatcher.dispatch(
+          new events.FinalizeUploadFailureEvent(error),
+          events.HttpFileUploaderEvents.FINALIZE_UPLOAD_FAILURE
+        );
+        return;
+      }
+      throw error;
+    }
+  }
+}
+
+exports.FinalizeUploadSubscriber = FinalizeUploadSubscriber;
+exports.InitializeUploadSubscriber = InitializeUploadSubscriber;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/subscribers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/subscribers/index.ts"],"names":["HttpFileUploaderEvents","InitializeUploadStartedEvent","safeFetch","InitializeUploadFailureException","InitializeUploadFailureEvent","InitializeUploadSuccessEvent","HttpFetchError","FinalizeUploadFailureEvent"],"mappings":";;;;;;;;AAsCO,MAAM,0BAAA,CAA+D;AAAA,EACxE,YAA6B,eAAA,EAA2C;AAA3C,IAAA,IAAA,CAAA,eAAA,GAAA,eAAA;AAAA,EAE7B;AAAA,EAzCJ;AAsC4E,IAAA,MAAA,CAAA,IAAA,EAAA,4BAAA,CAAA;AAAA;AAAA,EAKhE,mBAAA,GAAqG;AACzG,IAAA,OAAO;AAAA,MACH,CAACA,8BAAuB,iBAAiB,GAAG,EAAE,QAAA,EAAU,oBAAA,EAAsB,UAAU,GAAA;AAAG,KAC/F;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAa,mBAAmB,KAAA,EAA4C;AACxE,IAAA,KAAA,CAAM,eAAA,EAAgB;AACtB,IAAA,MAAM,gCAAgC,KAAA,CAAM,iBAAA;AAE5C,IAAA,IAAA,CAAK,eAAA,CAAgB,QAAA;AAAA,MACjB,IAAIC,mCAAA;AAAA,QACD,6BAAA,CAA8B,QAAA;AAAA,QAC7B,6BAAA,CAA8B,QAAA;AAAA,QAC9B,6BAAA,CAA8B;AAAA,OAClC;AAAA,MACAD,6BAAA,CAAuB;AAAA,KAC3B;AAEA,IAAA,IAAI;AACA,MAAA,MAAM,QAAA,GAAW,MAAME,qBAAA,CAAU;AAAA,QAC7B,KAAI,6BAAA,CAA8B,YAAA;AAAA,QAClC,UAAA,EAAY,MAAA;AAAA,QACZ,OAAA,EAAS;AAAA,UACL,cAAA,EAAgB,kBAAA;AAAA,UAChB,GAAG,6BAAA,CAA8B;AAAA,SACrC;AAAA,QACA,IAAA,EAAM;AAAA,UACF,UAAS,6BAAA,CAA8B,QAAA;AAAA,UACvC,UAAS,6BAAA,CAA8B,QAAA;AAAA,UACvC,UAAS,6BAAA,CAA8B,QAAA;AAAA,UACvC,UAAU,6BAAA,CAA8B,QAAA;AAAA,UACxC,UAAU,6BAAA,CAA8B;AAAA,SAC5C;AAAA,QACA,YAAA,EAAc,MAAA;AAAA,QACd,UAAA,EAAY,CAAA;AAAA,QACZ,iBAAA,EAAmB,IAAA;AAAA,QACnB,OAAA,EAAS;AAAA,OACZ,CAAA;AAED,MAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AAGxB,MAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,QAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,+BAAA,EAAkC,MAAM,CAAA,EAAA,CAAA,EAAM,QAAQ,CAAA;AAEpE,QAAA,MAAM,qBAAoB,IAAIC,2CAAA;AAAA,UAC1B,QAAA;AAAA,UACA,CAAA,4BAAA,EAA+B,SAAS,MAAM,CAAA;AAAA,SAClD;AAEA,QAAA,IAAA,CAAK,eAAA,CAAgB,QAAA;AAAA,UACjB,IAAIC,mCAAA;AAAA,YACA,kBAAA;AAAA,YACA,MAAA;AAAA,YACA,QAAA,CAAS;AAAA,WAAI;AAAA,UACjBJ,6BAAA,CAAuB;AAAA,SAE3B;AAEA,QAAA,MAAM,kBAAA;AAAA,MACV;AAEA,MAAA,MAAM,eAAe,QAAA,CAAS,IAAA;AAG9B,MAAA,IAAI,CAAC,YAAA,IAAgB,OAAO,YAAA,KAAiB,QAAA,EAAU;AACnD,QAAA,MAAM,eAAA,GAAkB,mDAAmD,OAAO,YAAA;AAClF,QAAA,OAAA,CAAQ,KAAA,CAAM,+BAA+B,YAAY,CAAA;AAEzD,QAAA,MAAM,IAAIG,2CAAA;AAAA,UACN,YAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ;AAEA,MAAA,IAAI,YACA,YAAA,CAAa,OAAA,IACb,aAAa,iBAAA,IACb,YAAA,CAAa,aACb,YAAA,CAAa,QAAA;AAEjB,MAAA,IAAI,CAAC,SAAA,EAAW;AACZ,QAAA,MAAM,eAAA,GAAkB,mGAAA;AAExB,QAAA,OAAA,CAAQ,KAAA,CAAM,mCAAmC,YAAY,CAAA;AAC7D,QAAA,MAAM,IAAIA,2CAAA;AAAA,UACN,YAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ;AAEA,MAAA,IAAI,OAAO,cAAc,QAAA,EAAU;AAAE,QAAA,SAAA,GAAY,UAAU,QAAA,EAAS;AAAA,MAAG;AAEvE,MAAA,KAAA,CAAM,WAAW,SAAS,CAAA;AAE1B,MAAA,IAAA,CAAK,eAAA,CAAgB,QAAA;AAAA,QACjB,IAAIE,mCAAA;AAAA,UACA,MAAA;AAAA,UACA,SAAA;AAAA,UACA;AAAA,SACJ;AAAA,QACAL,6BAAA,CAAuB;AAAA,OAC3B;AAAA,IAEJ,SAAS,KAAA,EAAO;AACZ,MAAA,IAAI,iBAAiBM,0BAAA,EAAgB;AACjC,QAAA,IAAA,CAAK,eAAA,CAAgB,QAAA;AAAA,UACjB,IAAIF,mCAAA;AAAA,YACA,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC;AAAA,WAC5D;AAAA,UACAJ,6BAAA,CAAuB;AAAA,SAC3B;AACA,QAAA;AAAA,MACJ;AACA,MAAA,OAAA,CAAQ,KAAA,CAAM,gCAAgC,KAAK,CAAA;AAEnD,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AACJ;AAEO,MAAM,wBAAA,CAA4D;AAAA,EAErE,YAA6B,eAAA,EAA2C;AAA3C,IAAA,IAAA,CAAA,eAAA,GAAA,eAAA;AAAA,EAE7B;AAAA,EAhLJ;AA4KyE,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA,EAM9D,mBAAA,GAAqG;AACxG,IAAA,OAAO;AAAA,MACH,CAACA,8BAAuB,eAAe,GAAG,EAAE,QAAA,EAAU,kBAAA,EAAoB,UAAU,GAAA;AAAI,KAC5F;AAAA,EACJ;AAAA,EAEA,MAAa,iBAAiB,KAAA,EAA0C;AACpE,IAAA,KAAA,CAAM,eAAA,EAAgB;AACtB,IAAA,IAAI;AACA,MAAA,MAAM,sBAAA,GAAyB,MAAME,qBAAA,CAAU;AAAA,QAC3C,KAAK,KAAA,CAAM,QAAA;AAAA,QACX,UAAA,EAAY,MAAA;AAAA,QACZ,OAAA,EAAS;AAAA,UACL,cAAA,EAAgB,kBAAA;AAAA,UAChB,GAAG,KAAA,CAAM;AAAA,SACb;AAAA,QACA,MAAM,EAAE,OAAA,EAAS,MAAM,OAAA,EAAS,SAAA,EAAW,MAAM,SAAA;AAAU,OAC9D,CAAA;AAED,MAAA,KAAA,CAAM,YAAY,sBAAsB,CAAA;AAAA,IAC5C,SAAS,KAAA,EAAO;AACZ,MAAA,IAAI,iBAAiBI,0BAAA,EAAgB;AACjC,QAAA,IAAA,CAAK,eAAA,CAAgB,QAAA;AAAA,UACjB,IAAIC,kCAA2B,KAAK,CAAA;AAAA,UACpCP,6BAAA,CAAuB;AAAA,SAC3B;AACA,QAAA;AAAA,MACJ;AAEA,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AACJ","file":"index.js","sourcesContent":["/*\n * This file is part of the project by AGBOKOUDJO Franck.\n *\n * (c) AGBOKOUDJO Franck <internationaleswebservices@gmail.com>\n * Phone: +229 0167 25 18 86\n * LinkedIn: https://www.linkedin.com/in/internationales-web-apps-services-120520193/\n * Company: INTERNATIONALES WEB APPS & SERVICES\n *\n * For more information, please feel free to contact the author.\n */\n\nimport {\n    EventSubscriberInterface,\n    EventDispatcherInterface\n} from \"@wlindabla/event_dispatcher\";\n\nimport {\n    HttpFileUploaderEvents,\n    InitializingUploadEvent,\n    InitializeUploadStartedEvent,\n    InitializeUploadSuccessEvent,\n    InitializeUploadFailureEvent,\n    FinalizeUploadEvent,\n    FinalizeUploadFailureEvent\n} from \"../events\";\n\nimport {\n    HttpFetchError,\n    safeFetch\n} from \"@wlindabla/http_client\";\n\nimport { InitializeUploadResponse } from \"../types\";\n\nimport { InitializeUploadFailureException } from \"../exceptions\";\n\n\n//src/subsciber/index.ts\n\nexport class InitializeUploadSubscriber implements EventSubscriberInterface {\n    constructor(private readonly eventDispatcher: EventDispatcherInterface) {\n        \n    }\n\n    public  getSubscribedEvents(): Record<string, string | { listener: string; priority?: number | undefined; }> {\n        return {\n            [HttpFileUploaderEvents.INITIALIZE_UPLOAD]: { listener: \"onInitializeUpload\", priority: 100}\n        }\n    }\n\n    /**\n    * Initializes upload session with the server.\n    * \n    * @param fileHash - SHA-256 hash of the file (first 1MB)\n    * @returns Session ID from server, or null if initialization failed\n    * @throws {FileUploadInitializationError} If server returns error or network fails\n    */\n    public async onInitializeUpload(event:InitializingUploadEvent):Promise<void>{\n        event.stopPropagation();\n        const initialzeUploadRequestOptions = event.initUploadOptions;\n\n        this.eventDispatcher.dispatch(\n            new InitializeUploadStartedEvent(\n               initialzeUploadRequestOptions.fileName,\n                initialzeUploadRequestOptions.fileSize,\n                initialzeUploadRequestOptions.fileHash\n            ),\n            HttpFileUploaderEvents.INITIALIZE_UPLOAD_STARTED\n        );\n            \n        try {\n            const response = await safeFetch({\n                url:initialzeUploadRequestOptions.endpointInit,\n                methodSend: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    ...initialzeUploadRequestOptions.headers\n                },\n                data: {\n                    fileName:initialzeUploadRequestOptions.fileName,\n                    fileSize:initialzeUploadRequestOptions.fileSize,\n                    fileHash:initialzeUploadRequestOptions.fileHash,\n                    fileType: initialzeUploadRequestOptions.fileType,\n                    metadata: initialzeUploadRequestOptions.metadata,\n                },\n                responseType: \"json\",\n                retryCount: 3,\n                retryOnStatusCode: true,\n                timeout: 45000\n            });\n\n            const status = response.status;\n           \n            // Handle error responses (4xx, 5xx)\n            if (response.failed) {\n                console.error(`Initialize upload failed (HTTP ${status}):`, response);\n\n                const errorUploadFailure =new InitializeUploadFailureException(\n                    response,\n                    `Server returned error: HTTP ${response.status}`\n                );\n\n                this.eventDispatcher.dispatch(\n                    new InitializeUploadFailureEvent(\n                        errorUploadFailure,\n                        status,\n                        response.data),\n                    HttpFileUploaderEvents.INITIALIZE_UPLOAD_FAILURE\n\n                );\n                \n                throw errorUploadFailure;\n            }\n\n            const responseData = response.data as InitializeUploadResponse;\n\n            // Validate server response struct\n            if (!responseData || typeof responseData !== 'object') {\n                const validationError = 'Invalid server response: expected object, got ' + typeof responseData\n                console.error('Invalid response structure:', responseData);\n\n                throw new InitializeUploadFailureException(\n                    responseData,\n                    validationError\n                );\n            }\n            // Extract session ID\n            let sessionId =\n                responseData.mediaId ||\n                responseData.mediaIdFromServer ||\n                responseData.sessionId ||\n                responseData.uploadId;\n\n            if (!sessionId) {\n                const missingKeyError = 'Server response missing required field: \"mediaId\",\"mediaIdFromServer\", \"sessionId\", or \"uploadId\"';\n\n                console.error('Missing session ID in response:', responseData);\n                throw new InitializeUploadFailureException(\n                    responseData,\n                    missingKeyError\n                );\n            }\n\n            if (typeof sessionId === \"number\") { sessionId = sessionId.toString(); }\n\n            event.setMediaId(sessionId);\n\n            this.eventDispatcher.dispatch(\n                new InitializeUploadSuccessEvent(\n                    status,\n                    sessionId,\n                    responseData\n                ),\n                HttpFileUploaderEvents.INITIALIZE_UPLOAD_SUCCESS\n            );\n\n        } catch (error) {\n            if (error instanceof HttpFetchError) {\n                this.eventDispatcher.dispatch(\n                    new InitializeUploadFailureEvent(\n                        error instanceof Error ? error : new Error(String(error)),\n                    ),\n                    HttpFileUploaderEvents.INITIALIZE_UPLOAD_FAILURE\n                );\n                return;\n            }\n            console.error('Initialize upload exception:', error);\n\n            throw error;\n        }\n    }\n}\n\nexport class FinalizeUploadSubscriber implements EventSubscriberInterface{\n\n    constructor(private readonly eventDispatcher: EventDispatcherInterface) {\n\n    }\n\n    public getSubscribedEvents(): Record<string, string | { listener: string; priority?: number | undefined; }> {\n        return {\n            [HttpFileUploaderEvents.FINALIZE_UPLOAD]: { listener: \"onFinalizeUpload\", priority: 100 }\n        }\n    }\n\n    public async onFinalizeUpload(event: FinalizeUploadEvent): Promise<void>{\n        event.stopPropagation();\n        try {\n            const responseFinalizeUpload = await safeFetch({\n                url: event.endPoint,\n                methodSend: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    ...event.headers\n                },\n                data: { mediaId: event.mediaId, mediaHash: event.mediaHash }\n            });\n\n            event.setResponse(responseFinalizeUpload)\n        } catch (error) {\n            if (error instanceof HttpFetchError) {\n                this.eventDispatcher.dispatch(\n                    new FinalizeUploadFailureEvent(error),\n                    HttpFileUploaderEvents.FINALIZE_UPLOAD_FAILURE\n                );\n                return;\n            }\n\n            throw error;\n        }\n    }\n}"]}

package/dist/types/index.js

@@ -0,0 +1,30 @@
+'use strict';
+
+var UploadState = /* @__PURE__ */ ((UploadState2) => {
+  UploadState2["IDLE"] = "idle";
+  UploadState2["INITIALIZING"] = "initializing";
+  UploadState2["UPLOADING"] = "uploading";
+  UploadState2["PAUSED"] = "paused";
+  UploadState2["CANCELLED"] = "cancelled";
+  UploadState2["FINALIZING"] = "finalizing";
+  UploadState2["COMPLETED"] = "completed";
+  UploadState2["FAILED"] = "failed";
+  return UploadState2;
+})(UploadState || {});
+const DEFAULT_CONFIG = Object.freeze({
+  defaultChunkSizeMB: 50,
+  slowSpeedThresholdMbps: 5,
+  slowSpeedChunkSizeMB: 2,
+  fileSizeThresholds: [
+    { maxSizeMB: 200, chunkSizeMB: 50 },
+    { maxSizeMB: 400, chunkSizeMB: 100 },
+    { maxSizeMB: 800, chunkSizeMB: 300 },
+    { maxSizeMB: 1e3, chunkSizeMB: 500 },
+    { maxSizeMB: Infinity, chunkSizeMB: 700 }
+  ]
+});
+
+exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.UploadState = UploadState;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"names":["UploadState"],"mappings":";;AAkEO,IAAK,WAAA,qBAAAA,YAAAA,KAAL;AACH,EAAAA,aAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,aAAA,cAAA,CAAA,GAAe,cAAA;AACf,EAAAA,aAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,aAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,aAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,aAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,aAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,aAAA,QAAA,CAAA,GAAS,QAAA;AARD,EAAA,OAAAA,YAAAA;AAAA,CAAA,EAAA,WAAA,IAAA,EAAA;AAiCL,MAAM,cAAA,GAA4C,OAAO,MAAA,CAAO;AAAA,EACnE,kBAAA,EAAoB,EAAA;AAAA,EACpB,sBAAA,EAAwB,CAAA;AAAA,EACxB,oBAAA,EAAsB,CAAA;AAAA,EACtB,kBAAA,EAAoB;AAAA,IAChB,EAAE,SAAA,EAAW,GAAA,EAAK,WAAA,EAAa,EAAA,EAAG;AAAA,IAClC,EAAE,SAAA,EAAW,GAAA,EAAK,WAAA,EAAa,GAAA,EAAI;AAAA,IACnC,EAAE,SAAA,EAAW,GAAA,EAAK,WAAA,EAAa,GAAA,EAAI;AAAA,IACnC,EAAE,SAAA,EAAW,GAAA,EAAM,WAAA,EAAa,GAAA,EAAI;AAAA,IACpC,EAAE,SAAA,EAAW,QAAA,EAAU,WAAA,EAAa,GAAA;AAAI;AAEhD,CAAC","file":"index.js","sourcesContent":["/*\n * This file is part of the project by AGBOKOUDJO Franck.\n *\n * (c) AGBOKOUDJO Franck <internationaleswebservices@gmail.com>\n * Phone: +229 0167 25 18 86\n * LinkedIn: https://www.linkedin.com/in/internationales-web-apps-services-120520193/\n * Company: INTERNATIONALES WEB APPS & SERVICES\n *\n * For more information, please feel free to contact the author.\n */\n\nimport { FetchResponseInterface } from \"@wlindabla/http_client\";\n\nexport interface UploadOptions {\n    autoSave?: boolean,\n    chunkSize?: number;\n    speedMbps?: number;\n    config?: ChunkSizeConfig;\n    headers?: HeadersInit;\n    chunkOtherData?: Record<string, any>;\n    metadata?: Record<string, any>;\n    maxRetries?: number;\n    timeout?: number;\n    initTimeout?: number;\n    headerInitialzingUpload?: HeadersInit;\n    headerFinalezingUpload?: HeadersInit;\n    concurrency?: number; // Default: 3\n}\n\nexport interface InitializeUploadOptions{\n    metadata?: Record<string, any>;\n    fileHash: string;\n    fileName: string;\n    fileSize: number;\n    fileType: string;\n    endpointInit: string | URL;\n    headers?: HeadersInit;\n}\n\nexport interface UploadEndpoints{\n    init: string | URL;\n    upload: string | URL;\n    finalize: string | URL;\n}\n\nexport interface ChunkSizeConfig {\n    defaultChunkSizeMB: number;\n    slowSpeedThresholdMbps: number;\n    slowSpeedChunkSizeMB: number;\n    fileSizeThresholds: Array<{\n        maxSizeMB: number;\n        chunkSizeMB: number;\n    }>;\n}\n\nexport type UploadStatus = 'pending' | 'uploading' | 'success' | 'error';\n\nexport interface ChunkInfo {\n    index: number;\n    start: number;\n    end: number;\n    size: number;\n    attempt: number;\n    status: UploadStatus;\n}\n\nexport enum UploadState {\n    IDLE = 'idle',\n    INITIALIZING = 'initializing',\n    UPLOADING = 'uploading',\n    PAUSED = 'paused',\n    CANCELLED = 'cancelled',\n    FINALIZING = 'finalizing',\n    COMPLETED = 'completed',\n    FAILED = 'failed'\n}\n\nexport interface UploadResult {\n    success: boolean;\n    fileId?: string;\n    totalChunks: number;\n    totalBytes: number;\n    duration: number;\n    averageSpeed: number;\n    finalizeUploadResponse?: FetchResponseInterface | null;\n    statusResponse?: number;\n}\n\nexport interface ResumeData {\n    fileId: string;\n    fileName: string;\n    fileSize: number;\n    uploadedChunks: number;\n    lastChunkIndex: number;\n    lastBytePosition: number;\n    chunkSize: number;\n    concurrency: number;\n}\n\nexport const DEFAULT_CONFIG: Readonly<ChunkSizeConfig> = Object.freeze({\n    defaultChunkSizeMB: 50,\n    slowSpeedThresholdMbps: 5,\n    slowSpeedChunkSizeMB: 2,\n    fileSizeThresholds: [\n        { maxSizeMB: 200, chunkSizeMB: 50 },\n        { maxSizeMB: 400, chunkSizeMB: 100 },\n        { maxSizeMB: 800, chunkSizeMB: 300 },\n        { maxSizeMB: 1000, chunkSizeMB: 500 },\n        { maxSizeMB: Infinity, chunkSizeMB: 700 }\n    ]\n});\n\nexport interface UploadProgress {\n    uploadedChunks: number;\n    totalChunks: number;\n    uploadedBytes: number;\n    totalBytes: number;\n    percentage: number;\n    currentChunk: number;\n    speed?: number; // bytes per second\n    estimatedTimeRemaining?: number | null; // seconds\n    elapsed: number;// secondes écoulées\n}\nexport interface ChunkError {\n    chunk: ChunkInfo;\n    error: Error;\n    attempt: number;\n    willRetry: boolean;\n}\n\n/**\n * Expected response structure from initialize endpoint\n */\nexport interface InitializeUploadResponse {\n    mediaIdFromServer?: string | number;\n    sessionId?: string | number;\n    uploadId?: string | number;\n    mediaId?: string | number;\n    message?: string | number;\n    [key: string]: any; // Allow extra fields\n}"]}

package/dist/utils/index.js

@@ -0,0 +1,183 @@
+'use strict';
+
+var types = require('../types');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class FileUtils {
+  static {
+    __name(this, "FileUtils");
+  }
+  static MB = 1024 * 1024;
+  static GB = 1024 * 1024 * 1024;
+  static bytesToMB(bytes) {
+    return parseFloat((bytes / this.MB).toFixed(2));
+  }
+  static bytesToGB(bytes) {
+    return parseFloat((bytes / this.GB).toFixed(2));
+  }
+  static formatBytes(bytes) {
+    if (bytes === 0) return "0 Bytes";
+    const k = 1024;
+    const sizes = ["Bytes", "KB", "MB", "GB", "TB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+  }
+  static formatDuration(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor(seconds % 3600 / 60);
+    const secs = Math.floor(seconds % 60);
+    if (hours > 0) return `${hours}h ${minutes}m ${secs}s`;
+    if (minutes > 0) return `${minutes}m ${secs}s`;
+    return `${secs}s`;
+  }
+  static calculateChunkSize(fileSize, speedMbps, config = types.DEFAULT_CONFIG) {
+    const fileSizeMB = fileSize / this.MB;
+    if (speedMbps && speedMbps < config.slowSpeedThresholdMbps) {
+      return Math.min(
+        config.defaultChunkSizeMB * this.MB,
+        config.slowSpeedChunkSizeMB * this.MB
+      );
+    }
+    for (const threshold of config.fileSizeThresholds) {
+      if (fileSizeMB <= threshold.maxSizeMB) {
+        return threshold.chunkSizeMB * this.MB;
+      }
+    }
+    return config.defaultChunkSizeMB * this.MB;
+  }
+  static generateFileHash(file) {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onload = async (e) => {
+        try {
+          const buffer = e.target?.result;
+          const hashBuffer = await crypto.subtle.digest("SHA-256", buffer.slice(0, 1024 * 1024));
+          const hashArray = Array.from(new Uint8Array(hashBuffer));
+          const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+          resolve(hashHex);
+        } catch (error) {
+          reject(error);
+        }
+      };
+      reader.onerror = reject;
+      reader.readAsArrayBuffer(file.slice(0, 1024 * 1024));
+    });
+  }
+}
+function updateProgressBarHTMLNotified(progress, media_id, filename, providerName = "LocalVideo") {
+  const progressBarId = `progress-bar-item_${providerName}_${media_id}`;
+  const progressBarContainer = document.querySelector(`#${progressBarId}`);
+  const progressBarInner = progressBarContainer?.querySelector(".progress-bar");
+  if (progressBarInner) {
+    const roundedProgress = Math.round(progress);
+    progressBarInner.style.width = `${progress}%`;
+    progressBarInner.setAttribute("aria-valuenow", progress.toString());
+    progressBarInner.innerText = `${roundedProgress}%`;
+    return progressBarContainer.innerHTML;
+  } else {
+    return `
+            <div id="${progressBarId}" class="mb-2" style="width:100%;">
+                <small class="control-label text-dark fw-bolder filename-label w-100 d-block text-truncate" title="${filename}">
+                    ${filename}
+                </small>
+                <div class="progress">
+                    <div class="progress-bar bg-success progress-bar-striped progress-bar-animated"
+                         role="progressbar"
+                         style="width: ${progress}%;"
+                         aria-valuenow="${progress}"
+                         aria-valuemin="0"
+                         aria-valuemax="100">${Math.round(progress)}%</div>
+                </div>
+            </div>`;
+  }
+}
+__name(updateProgressBarHTMLNotified, "updateProgressBarHTMLNotified");
+function createChunkFormData(chunk, options) {
+  const formData = new FormData();
+  formData.append("chunk", chunk);
+  formData.append("chunkIndex", options.chunkIndex.toString());
+  formData.append("chunkSize", chunk.size.toString());
+  formData.append("totalChunks", options.totalChunks.toString());
+  formData.append("fileName", options.fileName);
+  formData.append("fileSize", options.fileSize.toString());
+  formData.append("fileHash", options.fileHash);
+  formData.append("mediaId", options.mediaId);
+  if (options.metadata) {
+    for (const [key, value] of Object.entries(options.metadata)) {
+      if (typeof value === "string" || value instanceof Blob) {
+        formData.append(key, value);
+      }
+    }
+  }
+  return formData;
+}
+__name(createChunkFormData, "createChunkFormData");
+class ChunkFormDataBuilder {
+  static {
+    __name(this, "ChunkFormDataBuilder");
+  }
+  formData;
+  constructor(chunk) {
+    this.formData = new FormData();
+    this.formData.append("chunk", chunk);
+    this.formData.append("chunkSize", chunk.size.toString());
+  }
+  withChunkInfo(chunkIndex, totalChunks) {
+    this.formData.append("chunkIndex", chunkIndex.toString());
+    this.formData.append("totalChunks", totalChunks.toString());
+    return this;
+  }
+  withFileInfo(fileName, fileSize, fileHash) {
+    this.formData.append("fileName", fileName);
+    this.formData.append("fileSize", fileSize.toString());
+    this.formData.append("fileHash", fileHash);
+    return this;
+  }
+  withSessionId(sessionId) {
+    this.formData.append("sessionId", sessionId);
+    return this;
+  }
+  withMetadata(metadata) {
+    for (const [key, value] of Object.entries(metadata)) {
+      if (typeof value === "string" || value instanceof Blob) {
+        this.formData.append(key, value);
+      }
+    }
+    return this;
+  }
+  build() {
+    return this.formData;
+  }
+}
+class ExponentialBackoffStrategy {
+  static {
+    __name(this, "ExponentialBackoffStrategy");
+  }
+  shouldRetry(attempt, maxRetries) {
+    return attempt < maxRetries;
+  }
+  getDelay(attempt) {
+    return Math.pow(2, attempt) * 1e3;
+  }
+}
+class LinearBackoffStrategy {
+  static {
+    __name(this, "LinearBackoffStrategy");
+  }
+  shouldRetry(attempt, maxRetries) {
+    return attempt < maxRetries;
+  }
+  getDelay(attempt) {
+    return (attempt + 1) * 1e3;
+  }
+}
+
+exports.ChunkFormDataBuilder = ChunkFormDataBuilder;
+exports.ExponentialBackoffStrategy = ExponentialBackoffStrategy;
+exports.FileUtils = FileUtils;
+exports.LinearBackoffStrategy = LinearBackoffStrategy;
+exports.createChunkFormData = createChunkFormData;
+exports.updateProgressBarHTMLNotified = updateProgressBarHTMLNotified;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts"],"names":["DEFAULT_CONFIG"],"mappings":"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","file":"index.js","sourcesContent":["/*\n * This file is part of the project by AGBOKOUDJO Franck.\n *\n * (c) AGBOKOUDJO Franck <internationaleswebservices@gmail.com>\n * Phone: +229 0167 25 18 86\n * LinkedIn: https://www.linkedin.com/in/internationales-web-apps-services-120520193/\n * Company: INTERNATIONALES WEB APPS & SERVICES\n *\n * For more information, please feel free to contact the author.\n */\nimport {\n    ChunkSizeConfig,\n    DEFAULT_CONFIG\n} from \"../types\";\n\nexport class FileUtils {\n    static readonly MB = 1024 * 1024;\n    static readonly GB = 1024 * 1024 * 1024;\n\n    static bytesToMB(bytes: number): number {\n        return parseFloat((bytes / this.MB).toFixed(2));\n    }\n\n    static bytesToGB(bytes: number): number {\n        return parseFloat((bytes / this.GB).toFixed(2));\n    }\n\n    static formatBytes(bytes: number): string {\n        if (bytes === 0) return '0 Bytes';\n        const k = 1024;\n        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n        const i = Math.floor(Math.log(bytes) / Math.log(k));\n        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];\n    }\n\n    static formatDuration(seconds: number): string {\n        const hours = Math.floor(seconds / 3600);\n        const minutes = Math.floor((seconds % 3600) / 60);\n        const secs = Math.floor(seconds % 60);\n\n        if (hours > 0) return `${hours}h ${minutes}m ${secs}s`;\n        if (minutes > 0) return `${minutes}m ${secs}s`;\n        return `${secs}s`;\n    }\n\n    static calculateChunkSize(\n        fileSize: number,\n        speedMbps?: number,\n        config: ChunkSizeConfig = DEFAULT_CONFIG\n    ): number {\n        const fileSizeMB = fileSize / this.MB;\n\n        // Handle slow connections\n        if (speedMbps && speedMbps < config.slowSpeedThresholdMbps) {\n            return Math.min(\n                config.defaultChunkSizeMB * this.MB,\n                config.slowSpeedChunkSizeMB * this.MB\n            );\n        }\n\n        // Adjust based on file size\n        for (const threshold of config.fileSizeThresholds) {\n            if (fileSizeMB <= threshold.maxSizeMB) {\n                return threshold.chunkSizeMB * this.MB;\n            }\n        }\n\n        return config.defaultChunkSizeMB * this.MB;\n    }\n\n    static generateFileHash(file: File|Blob): Promise<string> {\n        return new Promise((resolve, reject) => {\n            const reader = new FileReader();\n            reader.onload = async (e) => {\n                try {\n                    const buffer = e.target?.result as ArrayBuffer;\n                    const hashBuffer = await crypto.subtle.digest('SHA-256', buffer.slice(0, 1024 * 1024));\n                    const hashArray = Array.from(new Uint8Array(hashBuffer));\n                    const hashHex = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');\n                    resolve(hashHex);\n                } catch (error) {\n                    reject(error);\n                }\n            };\n            reader.onerror = reject;\n            reader.readAsArrayBuffer(file.slice(0, 1024 * 1024)); // Hash first 1MB\n        });\n    }\n}\n\nexport function updateProgressBarHTMLNotified(\n    progress: number,\n    media_id: number,\n    filename: string,\n    providerName = \"LocalVideo\"\n): string {\n    const progressBarId = `progress-bar-item_${providerName}_${media_id}`;\n    // On cherche la barre de progression interne (celle qui a la classe .progress-bar)\n    const progressBarContainer = document.querySelector(`#${progressBarId}`);\n    const progressBarInner = progressBarContainer?.querySelector('.progress-bar') as HTMLElement;\n\n    if (progressBarInner) {\n        //  Mise à jour du DOM existant\n        const roundedProgress = Math.round(progress);\n        progressBarInner.style.width = `${progress}%`;\n        progressBarInner.setAttribute('aria-valuenow', progress.toString());\n        progressBarInner.innerText = `${roundedProgress}%`;\n\n        return progressBarContainer!.innerHTML;\n    } else {\n        // Génération du template initial\n        return `\n            <div id=\"${progressBarId}\" class=\"mb-2\" style=\"width:100%;\">\n                <small class=\"control-label text-dark fw-bolder filename-label w-100 d-block text-truncate\" title=\"${filename}\">\n                    ${filename}\n                </small>\n                <div class=\"progress\">\n                    <div class=\"progress-bar bg-success progress-bar-striped progress-bar-animated\"\n                         role=\"progressbar\"\n                         style=\"width: ${progress}%;\"\n                         aria-valuenow=\"${progress}\"\n                         aria-valuemin=\"0\"\n                         aria-valuemax=\"100\">${Math.round(progress)}%</div>\n                </div>\n            </div>`;\n    }\n}\n\n/**\n * Options for creating chunk FormData\n */\nexport interface ChunkFormDataOptions {\n    chunkIndex: number;\n    totalChunks: number;\n    mediaId: string;\n    fileName: string;\n    fileSize: number;\n    fileHash: string;\n    metadata?: Record<string, string | Blob>;\n}\n\n/**\n * Creates FormData for uploading a single file chunk.\n * \n * @param chunk - The chunk blob to upload\n * @param options - Chunk upload options\n * @returns FormData ready to be sent to the server\n * \n * @example\n * ```typescript\n    * const formData = createChunkFormData(blob, {\n        *   chunkIndex: 5,\n        *   totalChunks: 10,\n        *   mediaId: 'abc123',\n        *   fileName: 'video.mp4',\n        *   fileSize: 104857600,\n        *   fileHash: 'sha256...'\n * });\n * ```\n */\nexport function createChunkFormData(\n    chunk: Blob,\n    options: ChunkFormDataOptions\n): FormData {\n    const formData = new FormData();\n\n    // Chunk data\n    formData.append('chunk', chunk);\n    formData.append('chunkIndex', options.chunkIndex.toString());\n    formData.append('chunkSize', chunk.size.toString());\n    formData.append('totalChunks', options.totalChunks.toString());\n\n    // File metadata\n    formData.append('fileName', options.fileName);\n    formData.append('fileSize', options.fileSize.toString());\n    formData.append('fileHash', options.fileHash);\n\n    // Media ID (returned by server after metadata registration)\n    formData.append('mediaId', options.mediaId);\n\n    // Optional additional data\n    if (options.metadata) {\n        for (const [key, value] of Object.entries(options.metadata)) {\n            if (typeof value === 'string' || value instanceof Blob) {\n                formData.append(key, value);\n            }\n        }\n    }\n\n    return formData;\n}\n\n/**\n * Builder pattern for creating chunk FormData with fluent API.\n */\nexport class ChunkFormDataBuilder {\n    private formData: FormData ;\n\n    constructor(chunk: Blob) {\n        this.formData = new FormData();\n\n        this.formData.append('chunk', chunk);\n        this.formData.append('chunkSize', chunk.size.toString());\n    }\n\n    withChunkInfo(chunkIndex: number, totalChunks: number): this {\n        this.formData.append('chunkIndex', chunkIndex.toString());\n        this.formData.append('totalChunks', totalChunks.toString());\n        return this;\n    }\n\n    withFileInfo(fileName: string, fileSize: number, fileHash: string): this {\n        this.formData.append('fileName', fileName);\n        this.formData.append('fileSize', fileSize.toString());\n        this.formData.append('fileHash', fileHash);\n        return this;\n    }\n\n    withSessionId(sessionId: string): this {\n        this.formData.append('sessionId', sessionId);\n        return this;\n    }\n\n    withMetadata(metadata: Record<string, string | Blob>): this {\n        for (const [key, value] of Object.entries(metadata)) {\n            if (typeof value === 'string' || value instanceof Blob) {\n                this.formData.append(key, value);\n            }\n        }\n        return this;\n    }\n\n    build(): FormData {\n        return this.formData;\n    }\n}\n\n// Stratégie de retry configurable\ninterface RetryStrategyInterface {\n    shouldRetry(attempt: number, maxRetries: number, error: Error): boolean;\n    getDelay(attempt: number): number;\n}\n\nexport class ExponentialBackoffStrategy implements RetryStrategyInterface {\n    shouldRetry(attempt: number, maxRetries: number): boolean {\n        return attempt < maxRetries;\n    }\n\n    getDelay(attempt: number): number {\n        return Math.pow(2, attempt) * 1000;\n    }\n}\n\nexport class LinearBackoffStrategy implements RetryStrategyInterface {\n    shouldRetry(attempt: number, maxRetries: number): boolean {\n        return attempt < maxRetries;\n    }\n\n    getDelay(attempt: number): number {\n        return (attempt + 1) * 1000; // 1s, 2s, 3s...\n    }\n}\n"]}