Skip to content

Fix Path Handling in Build Challenge Map Script to Support Windows #594

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
NewtonLC wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Fix Path Handling in Build Challenge Map Script to Support Windows #594

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a8fc96f
Fix path handling on Build Challenge Map to support Windows
NewtonLC May 12, 2026
d106fb8
Update Outdated Build Challenge Map Comment
NewtonLC May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions scripts/build-challenge-map-graphql.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,17 +1,33 @@
import { writeFile, mkdir } from 'fs/promises';
import { dirname } from 'path';
import { fileURLToPath } from 'url';

/**
* Build challenge map from freeCodeCamp GraphQL Curriculum Database
*
* This script fetches the complete curriculum structure from the GraphQL API
* and generates a flat lookup map for challenge resolution.
*
* Output format: { challengeId: { certification, block, name } }
* Output format:
* {
* "challengeId": {
* "superblocks": ["superblock-dashed-name", ...],
* "blocks": ["block-dashed-name", ...],
* "name": "Challenge Title"
* }
* }
*
* Notes:
* - Challenges may appear in multiple superblocks/blocks; the script records
* all occurrences as arrays. Consumers that need a single canonical
* superblock/block (e.g., dashboard grouping) should use the first array
* element as the canonical value.
*/

const GRAPHQL_ENDPOINT = 'https://curriculum-db.freecodecamp.org/graphql';
const OUTPUT_PATH = new URL('../data/challengeMap.json', import.meta.url);
const OUTPUT_PATH = fileURLToPath(
new URL('../data/challengeMap.json', import.meta.url)
);

const CHALLENGE_MAP_QUERY = `
query GetChallengeMap {
Expand Down Expand Up @@ -158,14 +174,14 @@ async function buildChallengeMapFromGraphQL() {
const challengeMap = buildChallengeMap(data);

// Ensure output directory exists
await mkdir(dirname(OUTPUT_PATH.pathname), { recursive: true });
await mkdir(dirname(OUTPUT_PATH), { recursive: true });

// Write to file
console.log(`\n💾 Writing challenge map to ${OUTPUT_PATH.pathname}...`);
console.log(`\n💾 Writing challenge map to ${OUTPUT_PATH}...`);
await writeFile(OUTPUT_PATH, JSON.stringify(challengeMap, null, 2));

console.log('✅ Challenge map successfully generated!\n');
console.log(` File: ${OUTPUT_PATH.pathname}`);
console.log(` File: ${OUTPUT_PATH}`);
console.log(` Size: ${Object.keys(challengeMap).length} challenges`);
} catch (err) {
console.error('❌ Error building challenge map:', err);
Expand Down