chore: migrate config files, migrate redoc plugin to ESM

Author: barjin

apify-api/plugins/apify.js

@@ -0,0 +1,14 @@
+import ClientReferencesLinksDecorator from './decorators/client-references-links-decorator.mjs';
+import CodeSamplesDecorator from './decorators/code-samples-decorator.mjs';
+import LegacyDocUrlDecorator from './decorators/legacy-doc-url-decorator.mjs';
+
+export default () => ({
+    id: 'apify',
+    decorators: {
+        oas3: {
+            'legacy-doc-url-decorator': LegacyDocUrlDecorator,
+            'client-references-links-decorator': ClientReferencesLinksDecorator,
+            'code-samples-decorator': CodeSamplesDecorator,
+        },
+    },
+});

apify-api/plugins/apify.mjs

@@ -63,7 +63,7 @@ function ClientReferencesLinksDecorator(target) {
     target.description = `${prepend}${target.description || ''}`;
 }
 
-module.exports = () => ({
+export default () => ({
     // Redocly is using a visitor pattern. What the following code does is that whenever the traverser leaves a node of
     // type Tag or Operation, it executes prependLegacyUrlAnchor on it.
     Tag: {

apify-api/plugins/decorators/client-references-links-decorator.js renamed to apify-api/plugins/decorators/client-references-links-decorator.mjs

@@ -1,5 +1,5 @@
-const { existsSync } = require('node:fs');
-const path = require('node:path');
+import { existsSync } from 'node:fs';
+import path from 'node:path';
 
 const X_CODE_SAMPLES_PROPERTY = 'x-codeSamples';
 
@@ -31,7 +31,7 @@ function CodeSamplesDecorator(target) {
 
     for (const { lang, label, langSuffix } of LANGUAGES) {
         const codeSamplePath = path.join(
-            __dirname,
+            import.meta.dirname,
             `../../openapi/code_samples/${lang.toLowerCase()}/${operationId}.${langSuffix}`,
         );
 
@@ -55,7 +55,7 @@ function CodeSamplesDecorator(target) {
     }
 }
 
-module.exports = () => ({
+export default () => ({
     // Redocly is using a visitor pattern. What the following code does is that whenever the traverser leaves a node of
     // type Tag or Operation, it executes CodeSamplesDecorator on it.
     Tag: {

apify-api/plugins/decorators/code-samples-decorator.js renamed to apify-api/plugins/decorators/code-samples-decorator.mjs

@@ -37,7 +37,7 @@ function prependLegacyUrlAnchor(target) {
     }
 }
 
-module.exports = () => ({
+export default () => ({
     // Redocly is using a visitor pattern. What the following code does is that whenever the traverser leaves a node of
     // type Tag or Operation, it executes prependLegacyUrlAnchor on it.
     Tag: {

apify-api/plugins/decorators/legacy-doc-url-decorator.js renamed to apify-api/plugins/decorators/legacy-doc-url-decorator.mjs

@@ -8,21 +8,19 @@ extends:
 
 rules:
     # TODO we have quite a lot of errors in there, once we fix them, this should be flipped to `error` too
-    spec: warn
+    struct: warn
     no-unused-components: error
 
-theme:
+openapi:
     htmlTemplate: openapi/docs/index.html
-
-    openapi:
-        expandDefaultResponse: true
-        expandDefaultRequest: true
-        expandResponses: all
-        schemasExpansionLevel: 2
-        jsonSamplesExpandLevel: 2
+    expandDefaultResponse: true
+    expandDefaultRequest: true
+    expandResponses: all
+    schemasExpansionLevel: 2
+    jsonSamplesExpandLevel: 2
 
 plugins:
-    - apify-api/plugins/apify.js
+    - apify-api/plugins/apify.mjs
 
 decorators:
     apify/legacy-doc-url-decorator: on