test: adding integration tests setup

config/all-tags.json

@@ -177,6 +177,16 @@
       "color": "bg-[#E1224E]",
       "borderColor": "border-[#B9012b]"
     },
+    {
+      "name": "FastAPI",
+      "color": "bg-[#61d0f2]",
+      "borderColor": "border-[#40ccf7]"
+    },
+    {
+      "name": "Django",
+      "color": "bg-[#61d0f2]",
+      "borderColor": "border-[#40ccf7]"
+    },
     {
       "name": "Socket.IO",
       "color": "bg-[#61d0f2]",

config/meetings.json

@@ -1,156 +1,9 @@
 [
   {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=NWNsZmNtcXFlNDA5aXFxMTZ0MXI4OTBwMmsgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1830",
-    "banner": "",
-    "date": "2025-04-29T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=ZmQ4aHUxb2I4a244am5sMGJpdGF2MWM5bHMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1867",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-05-06T15:00:00.000Z"
-  },
-  {
-    "title": "Design WG Meeting ",
-    "calLink": "https://www.google.com/calendar/event?eid=MWxhNTc1cDRqZGc5cGdsdmZ0aWt1YnMwMWsgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1868",
-    "banner": "",
-    "date": "2025-05-01T16:00:00.000Z"
-  },
-  {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=ZmNmajEwN2J0M2E5anV2dnNhcXRwMWxlaWcgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1880",
-    "banner": "",
-    "date": "2025-05-13T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=NTJwZGM4Z2Flczc0bmRzY2czMjRwaXRjamMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1897",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-05-20T15:00:00.000Z"
-  },
-  {
-    "title": "Design Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=cHBvNWJ0aXMwODBhcmhpcWMwcXBucGp2bzggY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1905",
-    "banner": "",
-    "date": "2025-05-15T16:00:00.000Z"
-  },
-  {
-    "title": "Design WG Meeting ",
-    "calLink": "https://www.google.com/calendar/event?eid=OTdwMDl2dTlwdm9yNzRhZTV0ajdsbmQ5aW8gY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1908",
-    "banner": "",
-    "date": "2025-05-29T16:00:00.000Z"
-  },
-  {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=MWN2aGdmajFlbXF2NjllZGQ5ajZpaDJ2YWcgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1914",
-    "banner": "",
-    "date": "2025-05-27T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=dTFtbm1jZXJnbWowbDVvNjlmdmJqdDA0cjQgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1919",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-06-03T15:00:00.000Z"
-  },
-  {
-    "title": "GSoC Welcome Contributors Call",
-    "calLink": "https://www.google.com/calendar/event?eid=NGVwZ283cmRjcW1tZ2R1aG1maWR0Yzd1cWcgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1922",
-    "banner": "",
-    "date": "2025-05-29T10:00:00.000Z"
-  },
-  {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=am9saTZzYThlNjRobXN2M3NzZTN1YTFxbGsgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1927",
-    "banner": "",
-    "date": "2025-06-10T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Design WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=cmE2ZWY2ZGh2cWoxdmt1bGI4b2QxNGNvMDQgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1955",
-    "banner": "",
-    "date": "2025-06-19T16:00:00.000Z"
-  },
-  {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=djgzbHJjbm1oNmp2dDU2dTBsMmZrdWI0dGsgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1957",
-    "banner": "",
-    "date": "2025-06-24T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=anI1OG0yZHI5Y3JhOWx1YjdqZGlqOG5zbW8gY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1935",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-06-17T15:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=MXVzaXNyMWQ1djVyMzJvcXFkbWIzMG44dWsgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1962",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-07-01T15:00:00.000Z"
-  },
-  {
-    "title": "Marketing WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=Z2hrM2IzcTZma2FpbzlrNzJicDlxZjU1ZWMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1968",
-    "banner": "",
-    "date": "2025-07-08T14:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=c3Zkbmp1dmU3OGlpa203Y2pxYWt1cTNxZjggY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1969",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-07-15T15:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Design WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=YTZhYjdnZmtyYmM1aWo1aGNvOGxmODM1bW8gY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1971",
-    "banner": "",
-    "date": "2025-07-03T16:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=YWZtZ2xmNG9ndDhqbHBybHNiNWdiZnZodDQgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1988",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-07-29T15:00:00.000Z"
-  },
-  {
-    "title": "Governance Board Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=NG5nMTFoaHZramtjZTFpbWRrNjUwNTcwdm8gY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/1989",
-    "banner": "",
-    "date": "2025-07-29T13:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Community WG Meeting",
-    "calLink": "https://www.google.com/calendar/event?eid=MmZwZjVqMjQycTJ2ZTgwMmx1bjFua3ZjMHMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/2014",
-    "banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
-    "date": "2025-08-12T15:00:00.000Z"
-  },
-  {
-    "title": "AsyncAPI Design WG Meeting ",
-    "calLink": "https://www.google.com/calendar/event?eid=bzI2c2ZvaTAxNHNtMzBkOXBlcjU4cjA0azggY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
-    "url": "https://github.com/asyncapi/community/issues/2017",
-    "banner": "",
-    "date": "2025-08-07T16:00:00.000Z"
+    "title": "Community Meeting",
+    "calLink": "https://www.google.com/calendar/event?eid=example",
+    "url": "https://github.com/asyncapi/community/issues/123",
+    "banner": "https://example.com/banner.jpg",
+    "date": "2024-02-20T16:00:00.000Z"
   }
 ]

config/newsroom_videos.json

@@ -1,32 +1,14 @@
 [
   {
-    "image_url": "https://i.ytimg.com/vi/7vvdmDVZPX0/hqdefault.jpg",
-    "title": "AsyncAPI Community WG Meeting , Tuesday July 29th 2025",
-    "description": "https://github.com/asyncapi/community/issues/1988.",
-    "videoId": "7vvdmDVZPX0"
+    "image_url": "https://i.ytimg.com/vi/K7fvKbOfqOg/hqdefault.jpg",
+    "title": "Developer Experience Working Group, 14:00 UTC Thursday May 23rd 2024",
+    "description": "Define our vision and plans https://github.com/asyncapi/community/issues/1220.",
+    "videoId": "K7fvKbOfqOg"
   },
   {
-    "image_url": "https://i.ytimg.com/vi/SaIPQaROWsc/hqdefault.jpg",
-    "title": "First Meeting of New Governance Board , Tuesday July 29th 2025",
-    "description": "https://github.com/asyncapi/community/issues/1989.",
-    "videoId": "SaIPQaROWsc"
-  },
-  {
-    "image_url": "https://i.ytimg.com/vi/xD5smwg6az8/hqdefault.jpg",
-    "title": "AsyncAPI Community WG Meeting , Tuesday July 29th 2025",
-    "description": "https://github.com/asyncapi/community/issues/1988.",
-    "videoId": "xD5smwg6az8"
-  },
-  {
-    "image_url": "https://i.ytimg.com/vi/FkGnFqMTj88/hqdefault.jpg",
-    "title": "AsyncAPI Community WG Meeting, Tuesday July 15th 2025",
-    "description": "https://github.com/asyncapi/community/issues/1969.",
-    "videoId": "FkGnFqMTj88"
-  },
-  {
-    "image_url": "https://i.ytimg.com/vi/6AIUb1FNqEk/hqdefault.jpg",
-    "title": "AsyncAPI Community WG Meeting, Tuesday July 1st 2025",
-    "description": "https://github.com/asyncapi/community/issues/1962.",
-    "videoId": "6AIUb1FNqEk"
+    "image_url": "https://i.ytimg.com/vi/94SSXX78VCU/hqdefault.jpg",
+    "title": "Essential Building Blocks Working Group, 18:00 UTC Tuesday May 14th 2024",
+    "description": "https://github.com/asyncapi/community/issues/1200.",
+    "videoId": "94SSXX78VCU"
   }
 ]

jest.config.js

@@ -13,10 +13,9 @@ const config = {
     'scripts/tools/tags-color.ts',
     'scripts/helpers/logger.ts'
   ],
-  // Default: all tests
+  // Default: all tests except integration
   testMatch: [
     '**/tests/**/*.test.*',
-    '**/npm/integrationTests/**/*.test.*',
     '!**/netlify/**/*.test.*'
   ],
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],

npm/runners/build-adopters-list-runner.ts

@@ -1,22 +1,40 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
 import { buildAdoptersList } from '@/scripts/adopters';
 import { logger } from '@/scripts/helpers/logger';
 import { CustomError } from '@/types/errors/CustomError';
 
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = dirname(currentFilePath);
+
+export interface BuildAdoptersListOptions {
+  sourcePath?: string;
+  targetPath?: string;
+}
+
 /**
- * Runs the build adopters list process.
+ * Runs the build adopters list process with configurable options.
+ *
+ * This function determines the source YAML file path and the target JSON output path.
+ * It invokes the buildAdoptersList script and handles errors, logging them with context
+ * and letting the top-level .catch handle process exit.
  *
- * This function invokes the buildAdoptersList script and handles errors,
- * logging them with context and letting the top-level .catch handle process exit.
- * @throws {CustomError} When the build process fails
+ * @param options - Optional configuration for source and target paths.
+ * @throws {CustomError} When the build process fails or an error occurs in the runner.
  */
-async function runBuildAdoptersList(): Promise<void> {
+async function runBuildAdoptersList(options: BuildAdoptersListOptions = {}): Promise<void> {
   try {
-    await buildAdoptersList();
+    // Use provided options or fall back to default production paths
+    const sourcePath = options.sourcePath || resolve(currentDirPath, '../../config', 'adopters.yml');
+    const targetPath = options.targetPath || resolve(currentDirPath, '../../config', 'adopters.json');
+
+    await buildAdoptersList(sourcePath, targetPath);
   } catch (error) {
     const customError = CustomError.fromError(error, {
       category: 'script',
       operation: 'runBuildAdoptersList',
-      detail: 'Build adopters list runner failed'
+      detail: `Build adopters list failed - sourcePath: ${options.sourcePath}, targetPath: ${options.targetPath}`
     });
 
     logger.error('Build adopters list runner failed', customError);
@@ -25,11 +43,25 @@ async function runBuildAdoptersList(): Promise<void> {
   }
 }
 
-// Self-executing async function to handle top-level await
-(async () => {
-  try {
-    await runBuildAdoptersList();
-  } catch {
-    process.exit(1);
-  }
-})();
+// Only run CLI if NOT in test environment
+if (process.env.NODE_ENV !== 'test' && process.env.VITEST_WORKER_ID === undefined) {
+  // Self-executing async function to handle top-level await
+  (async () => {
+    try {
+      await runBuildAdoptersList();
+    } catch (error) {
+      const customError = CustomError.fromError(error, {
+        category: 'script',
+        operation: 'runBuildAdoptersList',
+        detail: 'Build adopters list runner CLI failed'
+      });
+
+      logger.error('Build adopters list runner CLI failed', customError);
+
+      process.exit(1);
+    }
+  })();
+}
+
+// Export for testing purposes
+export { runBuildAdoptersList };

npm/runners/build-dashboard-runner.ts

@@ -8,7 +8,7 @@ import { CustomError } from '@/types/errors/CustomError';
 const currentFilePath = fileURLToPath(import.meta.url);
 const currentDirPath = dirname(currentFilePath);
 
-interface BuildDashboardOptions {
+export interface BuildDashboardOptions {
   outputPath?: string;
 }
 
@@ -22,7 +22,7 @@ interface BuildDashboardOptions {
  * @param options - Optional configuration for output path
  * @throws {CustomError} If the build process fails or an error occurs in the runner
  */
-async function runBuildDashboard(options: BuildDashboardOptions = {}): Promise<void> {
+export async function runBuildDashboard(options: BuildDashboardOptions = {}): Promise<void> {
   try {
     const outputPath = options.outputPath || resolve(currentDirPath, '../../dashboard.json');
 
@@ -48,20 +48,20 @@ async function runBuildDashboard(options: BuildDashboardOptions = {}): Promise<v
   }
 }
 
-// Run only in non-test environments
-if (process.env.NODE_ENV === 'test') {
-  logger.info('Skipping dashboard build in test environment');
-} else {
-  // Self-executing async function to handle top-level await
+// Only run CLI if NOT in test environment (when imported by tests, don't auto-run)
+if (process.env.NODE_ENV !== 'test' && process.env.VITEST_WORKER_ID === undefined) {
   (async () => {
     try {
-      await runBuildDashboard();
+      // Extract output file path from CLI args
+      const outputFileArgIndex = process.argv.indexOf('--outputFile');
+      const outputPath =
+        outputFileArgIndex === -1 || !process.argv[outputFileArgIndex + 1]
+          ? resolve(currentDirPath, '../../dashboard.json')
+          : process.argv[outputFileArgIndex + 1];
+
+      await runBuildDashboard({ outputPath });
     } catch (error) {
-      // Ensure we exit with error code
       process.exit(1);
     }
   })();
 }
-
-// Export for testing purposes
-export { runBuildDashboard };

npm/runners/build-meetings-runner.ts

@@ -8,7 +8,7 @@ import { CustomError } from '@/types/errors/CustomError';
 const currentFilePath = fileURLToPath(import.meta.url);
 const currentDirPath = dirname(currentFilePath);
 
-interface BuildMeetingsOptions {
+export interface BuildMeetingsOptions {
   outputPath?: string;
 }
 
@@ -40,10 +40,8 @@ async function runBuildMeetings(options: BuildMeetingsOptions = {}): Promise<voi
   }
 }
 
-// Run only in non-test environments
-if (process.env.NODE_ENV === 'test') {
-  logger.info('Skipping meetings build in test environment');
-} else {
+// Only run CLI if NOT in test environment (when imported by tests, don't auto-run)
+if (process.env.NODE_ENV !== 'test' && process.env.VITEST_WORKER_ID === undefined) {
   // Self-executing async function to handle top-level await
   (async () => {
     try {