Birth of parseBool()

src/lib/common/utils.test.ts

@@ -0,0 +1,16 @@
+import { test, expect } from 'vitest';
+import * as utils from './utils';
+
+const TRUTHY_INPUT_DATA = ['TRUE', String(true), String(1)];
+for (const input of TRUTHY_INPUT_DATA) {
+  test(`correctly determines input value '${input}' as truthy`, () => {
+    expect(utils.parseBool(input)).toBe(true);
+  });
+}
+
+const FALSY_INPUT_DATA = ['FALSE', '', null, undefined, String(false), String(NaN), String(0)];
+for (const input of FALSY_INPUT_DATA) {
+  test(`correctly determines input value '${input}' as falsy`, () => {
+    expect(utils.parseBool(input)).toBe(false);
+  });
+}

src/lib/common/utils.ts

@@ -0,0 +1,10 @@
+export function parseBool(payload?: string | null, defaultValue = false): boolean {
+  if (!payload) return defaultValue;
+
+  payload = payload.trim().toLowerCase();
+
+  // unlikely NaN will be passed, but included to be safe
+  const stringsOtherwiseTruthy = [0, false, NaN].map((v) => String(v).toLowerCase());
+
+  return !stringsOtherwiseTruthy.includes(payload);
+}

src/lib/constants/index.ts

@@ -2,7 +2,7 @@ export * from './acm-paths';
 export * from './links';
 export * from './officers';
 
+import { parseBool } from '$lib/common/utils';
+
 // DEBUG flag is activated when anything besides '', '0', or 'false' is selected
-export const DEBUG = !['', '0', 'false', 'undefined'].includes(
-  String(import.meta.env.VITE_DEBUG).toLowerCase()
-);
+export const DEBUG = parseBool(import.meta.env.VITE_DEBUG);

src/lib/ical/utils.ts

@@ -2,13 +2,15 @@ import * as RRule from 'rrule/dist/es5/rrule.min.js';
 import { Temporal } from '@js-temporal/polyfill';
 import type { AcmPath } from '$lib/constants/acm-paths';
 import { acmAlgo, acmCreate, acmDev, acmGeneral } from '$lib/constants/acm-paths';
+import { parseBool } from '$lib/common/utils';
 
 export interface AcmEvent {
   month: string;
   day: number;
   time: string;
   hasStarted: boolean;
   hasEnded: boolean;
+  isPinned: boolean;
   duration: string;
   date: string;
   location: string;
@@ -312,6 +314,8 @@ export function makeAcmEvent(
     variables.get('ACM_LOCATION')
   );
 
+  const isPinned = parseBool(variables.get('ACM_PINNED'));
+
   const slug = makeEventSlug(title, dtStart);
 
   const selfLink = makeEventLink(slug);
@@ -351,6 +355,7 @@ export function makeAcmEvent(
     date,
     hasStarted,
     hasEnded,
+    isPinned,
     duration,
     location,
     title,

src/routes/events/_testdata/events.ics

@@ -63,7 +63,7 @@ RECURRENCE-ID;TZID=America/Los_Angeles:20220318T160000
 CREATED:20220311T160434Z
 DESCRIPTION:<html-blob>acmDev members assemble to collaboratively work on o
  ur semester projects to grow our development skills. This semester\, we are
-  hosting 4 different projects each with their own teams!<br>ACM_PATH=dev</h
+  hosting 4 different projects each with their own teams!<br>ACM_PATH=dev<br>ACM_PINNED=true</h
  tml-blob>
 LAST-MODIFIED:20220314T172514Z
 LOCATION:CS - 104

src/routes/events/_testdata/events.ts

@@ -6,6 +6,7 @@ export const events = [
     date: '2018-08-17T12:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'ACM & ACM-W Meeting',
@@ -35,6 +36,7 @@ export const events = [
     date: '2018-08-17T17:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'ACM Board Meeting',
@@ -64,6 +66,7 @@ export const events = [
     date: '2018-08-21T12:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'Personal Website Workshop Planning',
@@ -94,6 +97,7 @@ export const events = [
     date: '2018-08-24T09:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'Leadcon',
@@ -123,6 +127,7 @@ export const events = [
     date: '2018-09-10T17:30:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '15 minutes',
     location: 'CSUF Pollack Library SGSR113',
     title: 'Git Workshop Review',
@@ -154,6 +159,7 @@ export const events = [
     date: '2018-09-14T19:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'Project Jam Meeting',
@@ -184,6 +190,7 @@ export const events = [
     date: '2018-09-19T12:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'ROOM SGSR212 CSUF Pollak Library ',
     title: 'Personal Website Workshop Mock Presentation',
@@ -215,6 +222,7 @@ export const events = [
     date: '2018-10-02T16:00:00-07:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'PLN 434',
     title: 'Project Jam lead meeting',
@@ -246,6 +254,7 @@ export const events = [
     date: '2019-02-05T18:30:00-08:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'Website Meeting',
@@ -275,6 +284,7 @@ export const events = [
     date: '2019-02-06T10:30:00-08:00[America/Los_Angeles]',
     hasStarted: true,
     hasEnded: true,
+    isPinned: false,
     duration: '0 minutes',
     location: 'Discord',
     title: 'Workshop meeting',

src/routes/events/index.json.ts

@@ -2,6 +2,7 @@ import type { RequestHandlerOutput } from '@sveltejs/kit/types/internal';
 import type { AcmEvent } from '$lib/ical';
 import { parse } from '$lib/ical';
 import { DEBUG } from '$lib/constants';
+import { events as SAMPLE_EVENTS } from '../../routes/events/_testdata/events';
 
 // Constants
 const caching = false; // Make this false to disable server-side caching in development.
@@ -16,6 +17,11 @@ let events: AcmEvent[] = [];
 async function setCache(timestamp: number): Promise<AcmEvent[]> {
   const data = await fetch(ICAL_TARGET_URL).then((response) => response.text());
   events = parse(data, { maxEvents: DEBUG ? 10 : undefined });
+
+  if (DEBUG && events.length === 0) {
+    events = SAMPLE_EVENTS as AcmEvent[];
+  }
+
   eventExpirationTimestamp = timestamp + expirationTimeout;
   return events;
 }