fix(docs): Add workaround for ErrorMetadata typedef (#8737)

.jsdoc.js

@@ -61,6 +61,7 @@ module.exports = {
   plugins: [
     'plugins/markdown',
     'build/jsdoc-typeof-plugin',
+    'build/jsdoc-workarounds',
   ],
   markdown: {
     tags: ['example'],

build/jsdoc-workarounds.js

@@ -0,0 +1,13 @@
+/**
+ * This jsdoc plugin works around some typescript-flavoured jsdoc that isn't actual jsdoc,
+ * so docs:api doesn't fail
+ */
+exports.handlers = {
+  jsdocCommentFound: event => {
+    // Special case for media-error.js
+    event.comment = (event.comment || '').replace(
+      '@typedef {{errorType: string, [key: string]: any}} ErrorMetadata',
+      '@typedef {Object} ErrorMetadata\n * @property {string} errorType Error type'
+    );
+  }
+};