Shaping the New ALF Youth Alumni Community & Future Youth Programmes

/**
 * ALF / MYA Alumni Survey -> Google Sheets
 * Destination spreadsheet: 1scd00_CvjujOWbKHatFAwoOejVV_4iReGiA8Ug85rls
 * Deploy as a Web app: Execute as Me; access Anyone.
 */
const SPREADSHEET_ID = '1scd00_CvjujOWbKHatFAwoOejVV_4iReGiA8Ug85rls';
const SHEET_NAME = 'Responses';
const HEADERS = [
  "Submitted At",
  "ALF Young Leader Profile",
  "Programme Cycle",
  "Country of Origin",
  "Current Residence",
  "Birth Year",
  "Gender",
  "Professional / Interest Areas",
  "ALF Programme / Network",
  "Current Job Title / Role",
  "Organisation",
  "Sectors and Thematic Coalitions",
  "Thematic Coalitions",
  "Initiative / Project",
  "Key Programme Takeaway",
  "What Was Missing After the Programme",
  "Connection with Other Alumni",
  "Connection Scale",
  "Cross-Profile Collaboration Focus",
  "Community Priorities",
  "Trust / Collaboration",
  "Community Engagement",
  "Trust and Reaching Alumni",
  "Reaching Alumni",
  "Community Activities",
  "Preferred Formats",
  "Collaboration Opportunities",
  "Skills to Contribute",
  "Offer to Alumni Community",
  "Skills / Support Needed",
  "Needs / Challenges",
  "What Alumni Wish For",
  "What Should Be Added",
  "What Should Be Removed",
  "Safety / Inclusion Priority",
  "Safety Measures",
  "What ALF Should Do",
  "What ALF Should Not Do",
  "Online Townhall Interest",
  "Alumni Platform Ideas",
  "MYA II Ideas",
  "Consultation Results Format",
  "Co-design / Platform / MYA II Feedback",
  "Preferred Communication Channels",
  "Communication Frequency",
  "Full Name",
  "Email / Contact",
  "Privacy Consent",
  "Directory / Peer-Sharing Consent",
  "Additional Notes"
];
const FIELD_KEYS = [
  "submittedAt",
  "track",
  "q1_year",
  "q1_origin",
  "q1_location",
  "q1_birth_year",
  "q1_gender",
  "q2",
  "q3",
  "q3_role",
  "q3_org",
  "q4",
  "q4_themes",
  "q5_initiative",
  "q7_text",
  "q8_missing",
  "q9_contact",
  "q9_scale",
  "q9_track_focus",
  "q10",
  "q11",
  "q12",
  "q13_trust",
  "q13_reach",
  "q14",
  "q15_style",
  "q16",
  "q18_skills",
  "q17",
  "q18",
  "q19",
  "q19_wish",
  "q20",
  "q20_remove",
  "q21_safety",
  "q21_measures",
  "q22_do",
  "q22_dont",
  "q23_townhall",
  "q23_platform",
  "q23_mya2",
  "q23_results",
  "q23_codesign",
  "q24_channel",
  "q24_freq",
  "q25_name",
  "q25_contact",
  "q25_consent_privacy",
  "q25_consent_dir",
  "q25_notes"
];

function doGet(e) {
  // Health check only. Opening the URL never creates a dummy response.
  if (e && e.parameter && e.parameter.data) {
    return saveSubmission_(JSON.parse(e.parameter.data));
  }
  return ContentService.createTextOutput('ALF survey receiver is ready.');
}

function doPost(e) {
  try {
    let data = {};
    if (e && e.postData && e.postData.contents) {
      data = JSON.parse(e.postData.contents);
    } else if (e && e.parameter && e.parameter.data) {
      data = JSON.parse(e.parameter.data);
    } else {
      throw new Error('No survey response was received.');
    }
    return saveSubmission_(data);
  } catch (err) {
    return ContentService.createTextOutput('ERROR: ' + err.message);
  }
}

function saveSubmission_(data) {
  if (!data || typeof data !== 'object' || Array.isArray(data)) {
    throw new Error('Invalid response payload.');
  }
  const lock = LockService.getScriptLock();
  lock.waitLock(20000);
  try {
    const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
    let sheet = ss.getSheetByName(SHEET_NAME);
    if (!sheet) sheet = ss.insertSheet(SHEET_NAME);

    // Create/repair the header row before writing the first response.
    const firstCell = String(sheet.getRange(1, 1).getDisplayValue() || '').trim();
    if (firstCell !== HEADERS[0]) {
      sheet.insertRowBefore(1);
      sheet.getRange(1, 1, 1, HEADERS.length).setValues([HEADERS]);
      sheet.setFrozenRows(1);
      sheet.getRange(1, 1, 1, HEADERS.length)
        .setFontWeight('bold').setWrap(true);
    }

    const row = [new Date()].concat(FIELD_KEYS.slice(1).map(k => valueForCell_(data[k])));
    sheet.appendRow(row);
    return ContentService.createTextOutput('OK');
  } finally {
    lock.releaseLock();
  }
}

function valueForCell_(value) {
  if (value === null || value === undefined) return '';
  if (Array.isArray(value)) return value.join('; ');
  if (typeof value === 'object') return JSON.stringify(value);
  return value;
}

// Optional manual setup function. Run once in Apps Script if desired.
function setupHeaders() {
  const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
  let sheet = ss.getSheetByName(SHEET_NAME);
  if (!sheet) sheet = ss.insertSheet(SHEET_NAME);
  const firstCell = String(sheet.getRange(1, 1).getDisplayValue() || '').trim();
  if (firstCell !== HEADERS[0]) sheet.insertRowBefore(1);
  sheet.getRange(1, 1, 1, HEADERS.length).setValues([HEADERS]);
  sheet.setFrozenRows(1);
  sheet.getRange(1, 1, 1, HEADERS.length).setFontWeight('bold').setWrap(true);
}