@visulima/storage 1.0.0-alpha.9 → 1.0.1

package/dist/transformer/video-transformer.js

@@ -1,310 +1 @@
-import { Input, BufferSource, ALL_FORMATS, Output, BufferTarget, Conversion, Mp4OutputFormat, WebMOutputFormat, OggOutputFormat, MkvOutputFormat } from 'mediabunny';
-import BaseTransformer from '../packem_shared/BaseTransformer-C2gLib6v.js';
-import { isValidMediaType, getFormatFromContentType } from '../packem_shared/isValidMediaType-BeDgiObq.js';
-
-class VideoTransformer extends BaseTransformer {
-  /**
-   * Creates a new VideoTransformer instance.
-   * @param storage The storage backend for retrieving and storing video files.
-   * @param config Configuration options for video transformation including cache settings, codec defaults, and size limits.
-   */
-  constructor(storage, config = {}) {
-    const logger = config.logger || storage.logger;
-    const transformerConfig = {
-      cacheTtl: 3600,
-      // 1 hour
-      defaultBitrate: 2e6,
-      // 2 Mbps
-      defaultCodec: "avc",
-      // No cache provided - no caching
-      maxCacheSize: 50,
-      // Max 50 transformed videos in cache
-      maxVideoSize: 500 * 1024 * 1024,
-      // 500MB
-      supportedFormats: ["mp4", "webm", "mkv", "avi", "mov", "flv", "wmv"],
-      ...config
-    };
-    super(storage, transformerConfig, logger);
-  }
-  /**
-   * Resizes a video to specified dimensions with optional fit mode.
-   * @param fileId Unique identifier of the video file to resize.
-   * @param options Resize options including width, height, and fit mode.
-   * @returns Promise resolving to transformed video result.
-   */
-  async resize(fileId, options) {
-    return this.transform(fileId, [{ options, type: "resize" }]);
-  }
-  /**
-   * Crops a video to the specified region.
-   * @param fileId Unique identifier of the video file to crop.
-   * @param options Crop options including region coordinates.
-   * @returns Promise resolving to transformed video result.
-   */
-  async crop(fileId, options) {
-    return this.transform(fileId, [{ options, type: "crop" }]);
-  }
-  /**
-   * Rotates a video by the specified angle.
-   * @param fileId Unique identifier of the video file to rotate.
-   * @param options Rotation configuration with angle in degrees and optional background color.
-   * @returns Promise resolving to transformed video result.
-   */
-  async rotate(fileId, options) {
-    return this.transform(fileId, [{ options, type: "rotate" }]);
-  }
-  /**
-   * Converts video format or codec.
-   * @param fileId Unique identifier of the video file to convert.
-   * @param format Target video format (e.g., "mp4", "webm", "mkv").
-   * @param options Video transformation options including quality, bitrate, and codec settings.
-   * @returns Promise resolving to transformed video result with updated format metadata.
-   */
-  async convertFormat(fileId, format, options = {}) {
-    return this.transform(fileId, [{ options: { ...options, format }, type: "format" }]);
-  }
-  /**
-   * Transcodes video to different codec.
-   * @param fileId Unique identifier of the video file to transcode.
-   * @param codec Target video codec (e.g., "avc", "hevc", "vp9").
-   * @param options Additional transform options.
-   * @returns Promise resolving to transformed video result.
-   */
-  async transcode(fileId, codec, options = {}) {
-    return this.transform(fileId, [{ options: { ...options, codec }, type: "codec" }]);
-  }
-  /**
-   * Applies a custom transformation pipeline to a video.
-   * @param fileId Unique identifier of the video file to transform.
-   * @param steps Array of transformation steps to apply in sequence.
-   * @returns Promise resolving to transformed video result.
-   */
-  async transform(fileId, steps) {
-    const fileQuery = { id: fileId };
-    const cacheKey = this.generateCacheKey(fileId, steps);
-    if (this.cache) {
-      const cached = await Promise.resolve(this.cache.get(cacheKey));
-      if (cached) {
-        this.logger?.debug("Returning cached transformed video for %s", fileId);
-        return cached;
-      }
-    }
-    const originalFile = await this.storage.get(fileQuery);
-    await this.validateVideo(originalFile);
-    const transformedBuffer = await this.applyTransformations(originalFile.content, steps);
-    const result = await this.createTransformResult(transformedBuffer, originalFile);
-    if (this.cache) {
-      this.cache.set(cacheKey, result);
-    }
-    return result;
-  }
-  /**
-   * Applies multiple transformations in sequence using Mediabunny.
-   * @param buffer The original video buffer.
-   * @param steps Array of video transformation steps to apply.
-   * @returns Promise resolving to transformed video buffer.
-   * @private
-   */
-  async applyTransformations(buffer, steps) {
-    const input = new Input({
-      formats: ALL_FORMATS,
-      source: new BufferSource(buffer)
-    });
-    const outputFormat = this.determineOutputFormat(steps);
-    const output = new Output({
-      format: outputFormat,
-      target: new BufferTarget()
-    });
-    const videoOptions = this.stepsToVideoOptions(steps);
-    const conversion = await Conversion.init({
-      input,
-      output,
-      video: videoOptions
-    });
-    if (!conversion.isValid) {
-      const reasons = conversion.discardedTracks.map((track) => track.reason).join(", ");
-      throw new Error(`Video transformation failed: ${reasons}`);
-    }
-    await conversion.execute();
-    return Buffer.from(output.target.buffer);
-  }
-  /**
-   * Converts transformation steps to Mediabunny video options.
-   * @param steps Array of video transformation steps to convert.
-   * @returns Mediabunny video options object for conversion.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  stepsToVideoOptions(steps) {
-    const options = {};
-    for (const step of steps) {
-      switch (step.type) {
-        case "bitrate": {
-          const bitrateOptions = step.options;
-          if (bitrateOptions.bitrate) {
-            options.bitrate = bitrateOptions.bitrate;
-          }
-          break;
-        }
-        case "codec": {
-          const codecOptions = step.options;
-          if (codecOptions.codec) {
-            options.codec = codecOptions.codec;
-          }
-          if (codecOptions.bitrate) {
-            options.bitrate = codecOptions.bitrate;
-          }
-          break;
-        }
-        case "crop": {
-          const cropOptions = step.options;
-          options.crop = {
-            height: cropOptions.height,
-            left: cropOptions.left,
-            top: cropOptions.top,
-            width: cropOptions.width
-          };
-          break;
-        }
-        case "frameRate": {
-          const frameRateOptions = step.options;
-          if (frameRateOptions.frameRate) {
-            options.frameRate = frameRateOptions.frameRate;
-          }
-          break;
-        }
-        case "resize": {
-          const resizeOptions = step.options;
-          options.width = resizeOptions.width;
-          options.height = resizeOptions.height;
-          options.fit = resizeOptions.fit;
-          if (resizeOptions.position !== void 0) {
-            options.position = resizeOptions.position;
-          }
-          break;
-        }
-        case "rotate": {
-          const rotateOptions = step.options;
-          options.rotate = rotateOptions.angle;
-          if (rotateOptions.background) {
-            options.background = rotateOptions.background;
-          }
-          break;
-        }
-      }
-    }
-    return options;
-  }
-  /**
-   * Determines output format based on transformation steps.
-   * @param steps Array of video transformation steps.
-   * @returns Mediabunny output format instance (defaults to MP4).
-   * @private
-   */
-  determineOutputFormat(steps) {
-    for (const step of steps) {
-      if (step.type === "format" && step.options.format) {
-        return this.formatStringToOutputFormat(step.options.format);
-      }
-    }
-    return new Mp4OutputFormat();
-  }
-  /**
-   * Converts format string to Mediabunny output format.
-   * @param format Video format string (mp4, webm, mkv, ogg).
-   * @returns Mediabunny output format instance.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  formatStringToOutputFormat(format) {
-    switch (format.toLowerCase()) {
-      case "mkv": {
-        return new MkvOutputFormat();
-      }
-      case "mp4": {
-        return new Mp4OutputFormat();
-      }
-      case "ogg": {
-        return new OggOutputFormat();
-      }
-      case "webm": {
-        return new WebMOutputFormat();
-      }
-      default: {
-        return new Mp4OutputFormat();
-      }
-    }
-  }
-  /**
-   * Validates that the file is a supported video.
-   * @param file The file to validate.
-   * @returns Promise that resolves if validation passes.
-   * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid video.
-   * @private
-   */
-  async validateVideo(file) {
-    const fileSize = typeof file.size === "string" ? Number.parseInt(file.size, 10) : file.size;
-    if (this.config?.maxVideoSize && fileSize > this.config.maxVideoSize) {
-      throw new Error(`Video size ${fileSize} exceeds maximum allowed size ${this.config.maxVideoSize}`);
-    }
-    if (!isValidMediaType(file.contentType, "video")) {
-      throw new Error(`File is not a video: ${file.contentType}`);
-    }
-    const format = getFormatFromContentType(file.contentType);
-    if (this.config?.supportedFormats && format && !this.config.supportedFormats.includes(format)) {
-      throw new Error(`Unsupported video format: ${format}`);
-    }
-    try {
-      const input = new Input({
-        formats: ALL_FORMATS,
-        source: new BufferSource(file.content)
-      });
-      const primaryTrack = await input.getPrimaryVideoTrack();
-      if (!primaryTrack) {
-        throw new Error("No video track found");
-      }
-    } catch (error) {
-      throw new Error(`Invalid video file: ${error}`);
-    }
-  }
-  /**
-   * Creates transformation result with metadata.
-   * @param buffer The transformed video buffer.
-   * @param originalFile The original file information.
-   * @returns Video transformation result with metadata.
-   * @private
-   */
-  async createTransformResult(buffer, originalFile) {
-    const input = new Input({
-      formats: ALL_FORMATS,
-      source: new BufferSource(buffer)
-    });
-    const videoTrack = await input.getPrimaryVideoTrack();
-    const duration = await input.computeDuration();
-    return {
-      bitrate: this.config.defaultBitrate,
-      buffer,
-      duration,
-      format: "mp4",
-      // Default, would need to detect actual format
-      height: videoTrack?.displayHeight || 0,
-      originalFile,
-      size: buffer.length,
-      width: videoTrack?.displayWidth || 0
-    };
-  }
-  /**
-   * Generates cache key for transformation.
-   * @param fileId The file identifier.
-   * @param steps Array of transformation steps.
-   * @returns Unique cache key string.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  generateCacheKey(fileId, steps) {
-    const stepsKey = steps.map((step) => `${step.type}:${JSON.stringify(step.options)}`).join("|");
-    return `${fileId}:${stepsKey}`;
-  }
-}
-
-export { VideoTransformer as default };
+import{Input as c,BufferSource as p,ALL_FORMATS as f,Output as d,BufferTarget as h,Conversion as w,Mp4OutputFormat as m,WebMOutputFormat as g,OggOutputFormat as l,MkvOutputFormat as y}from"mediabunny";import b from"../packem_shared/BaseTransformer-Buw5lX_3.js";import{isValidMediaType as v,getFormatFromContentType as T}from"../packem_shared/getFormatFromContentType-DCTTPQHm.js";class V extends b{constructor(o,t={}){const r=t.logger||o.logger,e={cacheTtl:3600,defaultBitrate:2e6,defaultCodec:"avc",maxCacheSize:50,maxVideoSize:500*1024*1024,supportedFormats:["mp4","webm","mkv","avi","mov","flv","wmv"],...t};super(o,e,r)}async resize(o,t){return this.transform(o,[{options:t,type:"resize"}])}async crop(o,t){return this.transform(o,[{options:t,type:"crop"}])}async rotate(o,t){return this.transform(o,[{options:t,type:"rotate"}])}async convertFormat(o,t,r={}){return this.transform(o,[{options:{...r,format:t},type:"format"}])}async transcode(o,t,r={}){return this.transform(o,[{options:{...r,codec:t},type:"codec"}])}async transform(o,t){const r={id:o},e=this.generateCacheKey(o,t);if(this.cache){const n=await Promise.resolve(this.cache.get(e));if(n)return this.logger?.debug("Returning cached transformed video for %s",o),n}const i=await this.storage.get(r);await this.validateVideo(i);const s=await this.applyTransformations(i.content,t),a=await this.createTransformResult(s,i);return this.cache&&this.cache.set(e,a),a}async applyTransformations(o,t){const r=new c({formats:f,source:new p(o)}),e=this.determineOutputFormat(t),i=new d({format:e,target:new h}),s=this.stepsToVideoOptions(t),a=await w.init({input:r,output:i,video:s});if(!a.isValid){const n=a.discardedTracks.map(u=>u.reason).join(", ");throw new Error(`Video transformation failed: ${n}`)}return await a.execute(),Buffer.from(i.target.buffer)}stepsToVideoOptions(o){const t={};for(const r of o)switch(r.type){case"bitrate":{const e=r.options;e.bitrate&&(t.bitrate=e.bitrate);break}case"codec":{const e=r.options;e.codec&&(t.codec=e.codec),e.bitrate&&(t.bitrate=e.bitrate);break}case"crop":{const e=r.options;t.crop={height:e.height,left:e.left,top:e.top,width:e.width};break}case"frameRate":{const e=r.options;e.frameRate&&(t.frameRate=e.frameRate);break}case"resize":{const e=r.options;t.width=e.width,t.height=e.height,t.fit=e.fit,e.position!==void 0&&(t.position=e.position);break}case"rotate":{const e=r.options;t.rotate=e.angle,e.background&&(t.background=e.background);break}}return t}determineOutputFormat(o){for(const t of o)if(t.type==="format"&&t.options.format)return this.formatStringToOutputFormat(t.options.format);return new m}formatStringToOutputFormat(o){switch(o.toLowerCase()){case"mkv":return new y;case"mp4":return new m;case"ogg":return new l;case"webm":return new g;default:return new m}}async validateVideo(o){const t=typeof o.size=="string"?Number.parseInt(o.size,10):o.size;if(this.config?.maxVideoSize&&t>this.config.maxVideoSize)throw new Error(`Video size ${t} exceeds maximum allowed size ${this.config.maxVideoSize}`);if(!v(o.contentType,"video"))throw new Error(`File is not a video: ${o.contentType}`);const r=T(o.contentType);if(this.config?.supportedFormats&&r&&!this.config.supportedFormats.includes(r))throw new Error(`Unsupported video format: ${r}`);try{if(!await new c({formats:f,source:new p(o.content)}).getPrimaryVideoTrack())throw new Error("No video track found")}catch(e){throw new Error(`Invalid video file: ${e}`)}}async createTransformResult(o,t){const r=new c({formats:f,source:new p(o)}),e=await r.getPrimaryVideoTrack(),i=await r.computeDuration();return{bitrate:this.config.defaultBitrate,buffer:o,duration:i,format:"mp4",height:e?.displayHeight||0,originalFile:t,size:o.length,width:e?.displayWidth||0}}generateCacheKey(o,t){const r=t.map(e=>`${e.type}:${JSON.stringify(e.options)}`).join("|");return`${o}:${r}`}}export{V as default};