rx-player 4.0.0-beta.1 → 4.0.0-beta.2

package/src/public_types.ts

@@ -22,6 +22,7 @@ import {
   IPersistentSessionInfoV4,
 } from "./core/decrypt";
 import {
+  IMediaErrorTrackContext,
   EncryptedMediaError,
   MediaError,
   NetworkError,
@@ -31,6 +32,8 @@ import Manifest from "./manifest";
 import { ILocalManifest } from "./parsers/manifest/local";
 import { IMetaPlaylist } from "./parsers/manifest/metaplaylist/metaplaylist_parser";
 
+export { IMediaErrorTrackContext };
+
 /**
  * This file defines and exports types we want to expose to library users.
  * Those types are considered as part of the API.
@@ -693,6 +696,8 @@ export interface IAudioRepresentation {
   id : string|number;
   bitrate? : number | undefined;
   codec? : string | undefined;
+  isCodecSupported? : boolean | undefined;
+  seemsDecipherable? : boolean | undefined;
 }
 
 /** Audio track returned by the RxPlayer. */
@@ -720,7 +725,7 @@ export interface ITextTrack {
    * Kept equal to `language` if the attempt failed.
    */
   normalized : string;
-  forced? : boolean | undefined;
+  forced : boolean | undefined;
   closedCaption : boolean;
   label? : string | undefined;
   id : number|string;
@@ -738,6 +743,8 @@ export interface IVideoRepresentation {
   codec? : string | undefined;
   frameRate? : number | undefined;
   hdrInfo?: IHDRInformation | undefined;
+  isCodecSupported? : boolean | undefined;
+  seemsDecipherable? : boolean | undefined;
 }
 
 /** Video track returned by the RxPlayer. */
@@ -916,6 +923,14 @@ export interface ITrackUpdateEventPayload {
            "manual" | // Manually and explicitely updated
            "trickmode-enabled" | // Video trickmode tracks being enabled
            "trickmode-disabled" | // Video trickmode tracks being disabled
+           "no-playable-representation" | // Previous track had no playable Representation
+           string;
+}
+
+export interface IRepresentationListUpdateContext {
+  period : IPeriod;
+  trackType : ITrackType;
+  reason : "decipherability-update" |
            string;
 }
 

package/src/tools/TextTrackRenderer/text_track_renderer.ts

@@ -79,7 +79,7 @@ export default class TextTrackRenderer {
       args.timeOffset :
       0;
     this._segmentBuffer.pushChunkSync({ inventoryInfos: null,
-                                        data: { initSegment: null,
+                                        data: { initSegmentUniqueId: null,
                                                 codec: args.type,
                                                 timestampOffset,
                                                 appendWindow: [0, Infinity],

package/src/transports/smooth/isobmff/create_boxes.ts

@@ -33,7 +33,7 @@ import {
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @returns {Uint8Array}
@@ -68,7 +68,7 @@ function createAVC1Box(
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @param {Uint8Array} sinf - Uint8Array representing the sinf atom
@@ -108,8 +108,6 @@ function createENCVBox(
  * @param {Number} packetSize
  * @param {Number} sampleRate
  * @param {Uint8Array} esds - Uint8Array representing the esds atom
- * @param {Uint8Array} [sinf] - Uint8Array representing the sinf atom,
- * only if name == "enca"
  * @returns {Uint8Array}
  */
 function createMP4ABox(
@@ -164,7 +162,7 @@ function createENCABox(
 }
 
 /**
- * @param {url} Uint8Array
+ * @param {Uint8Array} url
  * @returns {Uint8Array}
  */
 function createDREFBox(url : Uint8Array) : Uint8Array {
@@ -415,7 +413,7 @@ function createSMHDBox() : Uint8Array {
 }
 
 /**
- * @param {Array.<Uint8Array>} representations - arrays of Uint8Array,
+ * @param {Array.<Uint8Array>} reps - arrays of Uint8Array,
  * typically [avc1] or [encv, avc1]
  * @returns {Uint8Array}
  */

package/src/typings/globals.d.ts

@@ -20,24 +20,24 @@
 /* eslint-disable @typescript-eslint/naming-convention */
 
 declare const __FEATURES__ : {
-  IS_ENABLED : number;
-  IS_DISABLED : number;
+  IS_DISABLED : 0;
+  IS_ENABLED : 1;
 
-  DASH : number;
-  DIRECTFILE : number;
-  EME : number;
-  HTML_SAMI : number;
-  HTML_SRT : number;
-  HTML_TTML : number;
-  HTML_VTT : number;
-  LOCAL_MANIFEST : number;
-  METAPLAYLIST : number;
-  DEBUG_ELEMENT : number;
-  NATIVE_SAMI : number;
-  NATIVE_SRT : number;
-  NATIVE_TTML : number;
-  NATIVE_VTT : number;
-  SMOOTH : number;
+  DASH : 0 | 1;
+  DIRECTFILE : 0 | 1;
+  EME : 0 | 1;
+  HTML_SAMI : 0 | 1;
+  HTML_SRT : 0 | 1;
+  HTML_TTML : 0 | 1;
+  HTML_VTT : 0 | 1;
+  LOCAL_MANIFEST : 0 | 1;
+  METAPLAYLIST : 0 | 1;
+  DEBUG_ELEMENT : 0 | 1;
+  NATIVE_SAMI : 0 | 1;
+  NATIVE_SRT : 0 | 1;
+  NATIVE_TTML : 0 | 1;
+  NATIVE_VTT : 0 | 1;
+  SMOOTH : 0 | 1;
 } | typeof FEATURES_ENUM;
 
 declare const enum FEATURES_ENUM {
@@ -62,9 +62,9 @@ declare const enum FEATURES_ENUM {
 }
 
 declare const __ENVIRONMENT__ : {
-  CURRENT_ENV : number;
-  DEV : number;
-  PRODUCTION : number;
+  CURRENT_ENV : 0 | 1;
+  DEV : 0;
+  PRODUCTION : 1;
 } | typeof ENVIRONMENT_ENUM;
 
 declare const enum ENVIRONMENT_ENUM {

package/src/utils/is_null_or_undefined.ts

@@ -20,7 +20,7 @@
  * not always understood by newcomers to the code, and which can be overused when
  * only one of the possibility can arise.
  * @param {*} x
- * @returns {*}
+ * @returns {boolean}
  */
 export default function isNullOrUndefined(x : unknown) : x is null | undefined | void {
   return x === null || x === undefined;

package/dist/_esm5.processed/core/init/utils/media_duration_updater.d.ts

@@ -1,56 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import Manifest from "../../../manifest";
-/**
- * Keep the MediaSource's duration up-to-date with what is being played.
- * @class MediaDurationUpdater
- */
-export default class MediaDurationUpdater {
-    private _canceller;
-    /**
-     * The last known audio Adaptation (i.e. track) chosen for the last Period.
-     * Useful to determinate the duration of the current content.
-     * `undefined` if the audio track for the last Period has never been known yet.
-     * `null` if there are no chosen audio Adaptation.
-     */
-    private _currentKnownDuration;
-    /**
-     * Create a new `MediaDurationUpdater` that will keep the given MediaSource's
-     * duration as soon as possible.
-     * This duration will be updated until the `stop` method is called.
-     * @param {Object} manifest - The Manifest currently played.
-     * For another content, you will have to create another `MediaDurationUpdater`.
-     * @param {MediaSource} mediaSource - The MediaSource on which the content is
-     * pushed.
-     */
-    constructor(manifest: Manifest, mediaSource: MediaSource);
-    /**
-     * By default, the `MediaDurationUpdater` only set a safe estimate for the
-     * MediaSource's duration.
-     * A more precize duration can be set by communicating to it a more precize
-     * media duration through `updateKnownDuration`.
-     * If the duration becomes unknown, `undefined` can be given to it so the
-     * `MediaDurationUpdater` goes back to a safe estimate.
-     * @param {number | undefined} newDuration
-     */
-    updateKnownDuration(newDuration: number | undefined): void;
-    /**
-     * Stop the `MediaDurationUpdater` from updating and free its resources.
-     * Once stopped, it is not possible to start it again, beside creating another
-     * `MediaDurationUpdater`.
-     */
-    stop(): void;
-}

package/scripts/doc-generator/construct_table_of_contents.js

@@ -1,76 +0,0 @@
-/**
- * Create table of contents in markdown referencing the h1 (#), h2 (##) and
- * h3 (###) titles.
- * Also add links to them to the original markdown.
- * @param {string} md - The markdown content
- * @returns {string}
- */
-function constructTableOfContents(md) {
-  const tocLines = [];
-  const newContent = [];
-  const lines = md.split(/\r\n|\n|\r/);
-
-  // Object used to avoid duplicates
-  const generatedAnchors = {};
-
-  // The inputed markdown is read line by line.
-  // When a h1, h2 or h3 is encountered in it, add a new list entry
-  // in the `tocLines` markdown respectively at top, second and third level.
-  // To be able to link the table of content to the corresponding content,
-  // add `<a>` links just before the corresponding h1, h2 or h3 elements in the
-  // inputed markdown.
-  // All Markdown parsing done here corresponds to the CommonMark spec (v0.29)
-  // TODO this might be more efficient and less error-prone if integrated as a
-  // markdown-it plugin.
-  for (let i = 0, len = lines.length; i < len; i++) {
-    if (/^ *# +/.test(lines[i])) {
-      const regExec = /^ *# +(.*)$/.exec(lines[i]);
-      if (regExec && regExec[1]) {
-        const tocLine = regExec[1].replace(/ #* *$/, "").trim();
-        let uri = generateAnchorName(tocLine);
-        tocLines.push(`[${tocLine}](#${uri})`);
-        newContent.push(`<a name="${uri}"></a>`);
-      }
-    } else if (/^ *## +/.test(lines[i])) {
-      const regExec = /^ *## +(.*)$/.exec(lines[i]);
-      if (regExec && regExec[1]) {
-        const tocLine = regExec[1].replace(/ #* *$/, "").trim();
-        let uri = generateAnchorName(tocLine);
-        tocLines.push(`  - [${tocLine}](#${uri})`);
-        newContent.push(`<a name="${uri}"></a>`);
-      }
-    } else if (/^ *### +/.test(lines[i])) {
-      const regExec = /^ *### +(.*)$/.exec(lines[i]);
-      if (regExec && regExec[1]) {
-        const tocLine = regExec[1].replace(/ #* *$/, "").trim();
-        let uri = generateAnchorName(tocLine);
-        tocLines.push(`    - [${tocLine}](#${uri})`);
-        newContent.push(`<a name="${uri}"></a>`);
-      }
-    }
-    newContent.push(lines[i]);
-  }
-  return {
-    tocMd: tocLines.join("\n"),
-    nbTocElements: tocLines.length,
-    content: newContent.join("\n"),
-  };
-
-  function generateAnchorName(title) {
-    const baseUri = encodeURI(title.toLowerCase().replace(/ /g, "_"))
-    if (generatedAnchors[baseUri] !== true) {
-      generatedAnchors[baseUri] = true;
-      return baseUri;
-    }
-    let i = 1;
-    let resultUri;
-    do {
-      resultUri = `${baseUri}_(${i})`;
-      i++;
-    } while (generatedAnchors[resultUri] === true);
-    generatedAnchors[resultUri] = true;
-    return resultUri;
-  }
-};
-
-module.exports = constructTableOfContents;

package/scripts/doc-generator/convert_MD_to_HMTL.js

@@ -1,26 +0,0 @@
-const hljs = require("highlight.js");
-const md = require("markdown-it")({
-  highlight(str, lang) {
-    if (lang && hljs.getLanguage(lang)) {
-      try {
-        return hljs.highlight(str, { language: lang }).value;
-      } catch (_) {
-        /* don't care for now */
-      }
-    }
-    return "";
-  },
-  html: true,
-  linkify: true,
-  typographer: true,
-  xhtmlOut: true,
-});
-
-/**
- * Convert the Markdown document given into an HTML page.
- * @param {string} mdStr
- * @returns {string}
- */
-module.exports = function convertMDToHTML(mdStr) {
-  return md.render(mdStr);
-};

package/scripts/doc-generator/create_documentation.js

@@ -1,331 +0,0 @@
-const { promisify } = require("util");
-const fs = require("fs");
-const path = require("path");
-const parseDocConfigs = require("./parse_doc_configs.js");
-const createDocumentationPage = require("./create_documentation_page.js");
-const generateHeaderHtml = require("./generate_header_html.js");
-const generatePageListHtml = require("./generate_page_list_html.js");
-const generateSidebarHtml = require("./generate_sidebar_html.js");
-const {
-  mkdirParent,
-  toUriCompatibleRelativePath,
-} = require("./utils.js");
-
-async function createDirIfDoesntExist(dir) {
-  const doesCSSOutDirExists = await promisify(fs.exists)(dir);
-  if (!doesCSSOutDirExists) {
-    try {
-      await mkdirParent(dir);
-    } catch (err) {
-      const srcMessage = (err ?? {}).message ?? "Unknown error";
-      console.error(`Error: Could not create "${dir}" directory: ${srcMessage}`);
-      process.exit(1);
-    }
-  }
-}
-
-/**
- * Create documentation for the directory given into the ouput directory given.
- * @param {string} baseInDir
- * @param {string} baseOutDir
- * @param {Object} [options={}]
- * @param {Function} [options.getPageTitle] - Callback returning the name of the
- * page, based on the name of a single markdown document.
- * If not set, the page title will just be the corresponding markdown's title.
- * @param {Array.<string>} [options.css] - Optional CSS files which will be
- * linked to each generated page.
- * Should be the path to each of those.
- * @param {string|undefined} [options.version] - String indicating the current
- * version of the documented application.
- * @returns {Promise} - Resolve when done
- */
-async function createDocumentation(
-  baseInDir,
-  baseOutDir,
-  options = {},
-) {
-  const { css } = options;
-
-  // Copy CSS files
-  const cssOutputDir = path.join(path.resolve(baseOutDir), "styles");
-  const cssOutputPaths = css.map(cssFilepath => {
-    return path.join(cssOutputDir, path.basename(cssFilepath));
-  });
-
-  if (css.length > 0) {
-    await createDirIfDoesntExist(cssOutputDir);
-    await Promise.all(css.map(async (cssInput, i) => {
-      await promisify(fs.copyFile)(cssInput, cssOutputPaths[i]);
-    }));
-  }
-
-  // Copy JavaScript file
-  const scriptOutputDir = path.join(path.resolve(baseOutDir), "scripts");
-  const scripts = [
-    path.join(__dirname, "scripts/lunr.js"),
-    path.join(__dirname, "scripts/script.js"),
-  ];
-  const scriptOutputPaths = scripts.map(s =>
-    path.join(scriptOutputDir, path.basename(s)));
-
-  await createDirIfDoesntExist(scriptOutputDir);
-  await Promise.all(scripts.map(async (s, i) => {
-    await promisify(fs.copyFile)(s, scriptOutputPaths[i]);
-  }));
-
-  // Construct tree listing categories, pages, and relations between them.
-  const config = await parseDocConfigs(baseInDir, baseOutDir, options.version);
-
-  if (config.favicon !== undefined && typeof config.favicon.srcPath === "string") {
-    await copyFileToOutputDir(config.favicon.srcPath, baseInDir, baseOutDir);
-  }
-  if (config.logo !== undefined && typeof config.logo.srcPath === "string") {
-    await copyFileToOutputDir(config.logo.srcPath, baseInDir, baseOutDir);
-  }
-
-
-  // Construct a dictionary of markdown files to the corresponding output file.
-  // This can be useful to redirect links to other converted markdowns.
-  const fileDict = config.links.reduce((acc, linkInfo) => {
-    if (linkInfo.type !== "local-doc") {
-      return acc;
-    }
-    return linkInfo.pages.reduce((acc2, pageInfo) => {
-      if (pageInfo.isPageGroup) {
-        return pageInfo.pages.reduce((acc3, subPageInfo) => {
-          acc3[subPageInfo.inputFile] = subPageInfo.outputFile;
-          return acc3;
-        }, acc2);
-      } else {
-        acc2[pageInfo.inputFile] = pageInfo.outputFile;
-      }
-      return acc2;
-    }, acc);
-  }, {});
-
-  const searchIndex = [];
-
-  // Create documentation pages
-  for (let linkIdx = 0; linkIdx < config.links.length; linkIdx++) {
-    const currentLink = config.links[linkIdx];
-    if (currentLink.type !== "local-doc") {
-      continue;
-    }
-    for (let pageIdx = 0; pageIdx < currentLink.pages.length; pageIdx++) {
-      const currentPage = currentLink.pages[pageIdx];
-      if (!currentPage.isPageGroup) {
-        const { inputFile, outputFile } = currentPage;
-        await prepareAndCreateDocumentationPage({
-          baseOutDir,
-          config,
-          cssOutputPaths,
-          fileDict,
-          inputFile,
-          linkIdx,
-          outputFile,
-          pageIdxs: [pageIdx],
-          pageTitle: options.getPageTitle === undefined ?
-            currentPage.displayName :
-            options.getPageTitle(currentPage.displayName),
-          scriptOutputPaths,
-          searchIndex,
-        });
-      } else {
-        for (
-          let subPageIdx = 0;
-          subPageIdx < currentPage.pages.length;
-          subPageIdx++
-        ) {
-          const currentSubPage = currentPage.pages[subPageIdx];
-          const { inputFile, outputFile } = currentSubPage;
-          await prepareAndCreateDocumentationPage({
-            baseOutDir,
-            config,
-            cssOutputPaths,
-            fileDict,
-            inputFile,
-            linkIdx,
-            outputFile,
-            pageIdxs: [pageIdx, subPageIdx],
-            pageTitle: options.getPageTitle === undefined ?
-              currentSubPage.displayName :
-              options.getPageTitle(currentSubPage.displayName),
-            scriptOutputPaths,
-            searchIndex,
-          });
-        }
-      }
-    }
-  }
-
-  try {
-    const searchIndexLoc = path.join(path.resolve(baseOutDir), "searchIndex.json");
-    await promisify(fs.writeFile)(searchIndexLoc, JSON.stringify(searchIndex));
-  } catch (err) {
-    const srcMessage = (err ?? {}).message ?? "Unknown error";
-    console.error(`Error: Could not create search index file: ${srcMessage}`);
-  }
-};
-
-async function prepareAndCreateDocumentationPage({
-  baseOutDir,
-  config,
-  cssOutputPaths,
-  fileDict,
-  inputFile,
-  linkIdx,
-  outputFile,
-  pageIdxs,
-  pageTitle,
-  scriptOutputPaths,
-  searchIndex,
-}) {
-  // Create output directory if it does not exist
-  const outDir = path.dirname(outputFile);
-  await createDirIfDoesntExist(outDir);
-
-  let logoInfo = null;
-  if (config.logo !== undefined) {
-    logoInfo = {};
-    if (config.logo !== undefined && typeof config.logo.link === "string") {
-      logoInfo.link = config.logo.link;
-    }
-    if (config.logo !== undefined && typeof config.logo.srcPath === "string") {
-      const fullPath =  path.join(baseOutDir, config.logo.srcPath);
-      logoInfo.url = toUriCompatibleRelativePath(fullPath, outDir);
-    }
-  }
-  let faviconUrl = null;
-  if (config.favicon !== undefined && typeof config.favicon.srcPath === "string") {
-    const fullPath =  path.join(baseOutDir, config.favicon.srcPath);
-    faviconUrl = toUriCompatibleRelativePath(fullPath, outDir);
-  }
-  const pageListHtml = generatePageListHtml(config.links, linkIdx, pageIdxs, outputFile);
-  const navBarHtml = generateHeaderHtml(config, linkIdx, outputFile, logoInfo);
-  const pages = config.links[linkIdx].pages;
-  const sidebarHtml = generateSidebarHtml(pages, pageIdxs, outputFile, logoInfo);
-
-  let prevPageConfig = null;
-  let nextPageConfig = null;
-  if (pageIdxs.length > 1 && pageIdxs[1] > 0) {
-    prevPageConfig = pages[pageIdxs[0]].pages[pageIdxs[1] - 1];
-  } else if (pageIdxs[0] > 0) {
-    prevPageConfig = pages[pageIdxs[0] - 1];
-  }
-  if (pageIdxs.length > 1 && pageIdxs[1] < pages[pageIdxs[0]].pages.length - 1) {
-    nextPageConfig = pages[pageIdxs[0]].pages[pageIdxs[1] + 1];
-  } else if (pageIdxs[0] < pages.length - 1) {
-    nextPageConfig = pages[pageIdxs[0] + 1];
-  }
-  const prevPageInfo = prevPageConfig === null ?
-    null :
-    getRelativePageInfo(prevPageConfig, outputFile);
-  const nextPageInfo = nextPageConfig === null ?
-    null :
-    getRelativePageInfo(nextPageConfig, outputFile);
-
-  const cssUrls = cssOutputPaths
-    .map(cssOutput => toUriCompatibleRelativePath(cssOutput, outDir));
-  const scriptUrls = scriptOutputPaths
-    .map(s => toUriCompatibleRelativePath(s, outDir));
-
-  // add link translation to options
-  const linkTranslator = linkTranslatorFactory(inputFile, outDir, fileDict);
-  await createDocumentationPage({
-    baseOutDir,
-    cssUrls,
-    faviconUrl,
-    inputFile,
-    linkTranslator,
-    navBarHtml,
-    nextPageInfo,
-    outputFile,
-    pageListHtml,
-    pageTitle,
-    prevPageInfo,
-    scriptUrls,
-    searchIndex,
-    sidebarHtml,
-  });
-}
-
-/**
- * Generate linkTranslator functions
- * @param {string} inputFile
- * @param {Object} fileDict
- * @returns {Function}
- */
-function linkTranslatorFactory(inputFile, outputDir, fileDict) {
-  /**
-   * Convert links to files that will be converted to the links of the
-   * corresponding converted output files.
-   * @param {string} link
-   * @returns {string|undefined}
-   */
-  return (link) => {
-    if (/^(?:[a-z]+:)/.test(link) || link[0] === "#") {
-      return
-    }
-    const extname = path.extname(link);
-    const indexOfAnchor = extname.indexOf("#");
-
-    const anchor = indexOfAnchor > 0 ?
-      extname.substring(indexOfAnchor) :
-      "";
-
-    const linkWithoutAnchor = link.substring(0, link.length - anchor.length);
-    const completeLink = path.join(path.dirname(inputFile), linkWithoutAnchor);
-    const normalizedLink = path.normalize(path.resolve(completeLink));
-
-    const translation = fileDict[normalizedLink];
-    if (translation === undefined) {
-      console.warn("WARNING: Local link not found.\n",
-                   "File:", inputFile, "\n",
-                   "Link:", link, "\n");
-    }
-    return translation !== undefined ?
-      toUriCompatibleRelativePath(translation, outputDir) + anchor :
-      // TODO do something better?
-      undefined;
-  };
-}
-
-function getRelativePageInfo(
-  pageConfig,
-  currentPath
-) {
-  const {
-    displayName: pDisplayName,
-    outputFile: pOutputFile
-  } = pageConfig.isPageGroup ?
-    pageConfig.pages[0] :
-    pageConfig;
-
-  const relativeHref = toUriCompatibleRelativePath(pOutputFile, path.dirname(currentPath));
-  return { name: pDisplayName, link: relativeHref };
-}
-
-async function copyFileToOutputDir(
-  filePathFromInputDir,
-  inputDir,
-  outputDir
-) {
-  const inputPath = path.join(inputDir, filePathFromInputDir);
-  const outputPath = path.join(outputDir, filePathFromInputDir);
-  const doesOutDirExists = await promisify(fs.exists)(path.dirname(outputPath));
-  if (!doesOutDirExists) {
-    try {
-      await mkdirParent(path.dirname(outputPath));
-    } catch (err) {
-      const srcMessage = (err ?? {}).message ?? "Unknown error";
-      console.error(`Error: Could not create "${outputPath}" directory: ${srcMessage}`);
-      process.exit(1);
-    }
-  }
-  const doesOutFileExist = await promisify(fs.exists)(outputPath);
-  if (!doesOutFileExist) {
-    await promisify(fs.copyFile)(inputPath, outputPath);
-  }
-}
-
-module.exports = createDocumentation;