@fc3/mmcadi 0.1.0

package/src/server/utility/day-to-date.ts

@@ -0,0 +1,40 @@
+import {InvalidError} from 'lib/errors';
+
+import Day from 'type/day';
+import MonthNames from 'constant/month-names';
+
+const month_segment = MonthNames.join('|');
+const DAY_REGEX = new RegExp(`^(${month_segment})-([0-9][0-9])-([0-9][0-9][0-9][0-9])$`);
+
+function dayToDate(day: Day): Date {
+	const {key} = day;
+	const match = key.match(DAY_REGEX);
+
+	if (!match) {
+		throw new InvalidError(`Invalid day: ${key}`);
+	}
+
+	const month_name = match[1];
+	const numeric_day = parseInt(match[2]);
+	const numeric_year = parseInt(match[3]);
+
+	if (isNaN(numeric_day)) {
+		throw new InvalidError(`Invalid day: ${key}`);
+	}
+
+	if (isNaN(numeric_year)) {
+		throw new InvalidError(`Invalid day: ${key}`);
+	}
+
+	const month_index = MonthNames.indexOf(month_name);
+
+	if (month_index === -1) {
+		throw new InvalidError(`Invalid day: ${key}`);
+	}
+
+	const numeric_month = month_index + 1;
+
+	return new Date(`${numeric_year}-${numeric_month}-${numeric_day}`);
+}
+
+export default dayToDate;

package/src/server/utility/decrement-date.ts

@@ -0,0 +1,11 @@
+import incrementDate from 'server/utility/increment-date';
+
+function decrementDate(date: Date, days?: number): Date {
+	if (days === undefined) {
+		days = -1;
+	}
+
+	return incrementDate(date, days);
+}
+
+export default decrementDate;

package/src/server/utility/get-block-at-index-path.ts

@@ -0,0 +1,32 @@
+import {NotFoundError} from 'lib/errors';
+
+import Page from 'type/page';
+import Block from 'type/block';
+import parseIndexPath from 'server/utility/parse-index-path';
+
+function getBlockAtIndexPath(page: Page, index_path: string): Block {
+	const parts = parseIndexPath(index_path);
+
+	let current_node: Block | undefined;
+	let siblings = page.blocks;
+
+	while (parts.length) {
+		const index = parts.shift() as number;
+
+		current_node = siblings[index];
+
+		if (current_node === undefined) {
+			throw new NotFoundError(`Unable to find block at index: ${index_path}`);
+		}
+
+		siblings = current_node.children || [];
+	}
+
+	if (current_node === undefined) {
+		throw new NotFoundError(`Unable to find block at index: ${index_path}`);
+	}
+
+	return current_node;
+}
+
+export default getBlockAtIndexPath;

package/src/server/utility/get-block-permissions.ts

@@ -0,0 +1,15 @@
+import PermissionType from 'enum/permission-type';
+import DefaultRole from 'enum/default-role';
+import Block from 'type/block';
+
+function getBlockPermissions(block: Block): Record<PermissionType, string> {
+	return {
+		[PermissionType.CREATE]: DefaultRole.CREATOR,
+		[PermissionType.READ]: DefaultRole.PUBLIC,
+		[PermissionType.UPDATE]: DefaultRole.CREATOR,
+		[PermissionType.DELETE]: DefaultRole.CREATOR,
+		...block.permissions
+	};
+}
+
+export default getBlockPermissions;

package/src/server/utility/get-compact-label-for-date.ts

@@ -0,0 +1,8 @@
+function getCompactLabelForDate(date: Date): string {
+	const month = date.getUTCMonth() + 1;
+	const day = date.getUTCDate();
+
+	return `${month}/${day}`;
+}
+
+export default getCompactLabelForDate;

package/src/server/utility/get-custom-page-type-for-path.ts

@@ -0,0 +1,37 @@
+import {StatusCode} from 'lib/http';
+
+import CustomPageType from 'server/enum/custom-page-type';
+import pathIsDate from 'server/utility/path-is-date';
+import isIndexPath from 'server/utility/is-index-path';
+
+function isDate(path: string): boolean {
+	return pathIsDate(path) && path.startsWith('/day/');
+}
+
+function isError(path: string): boolean {
+	const parsed_key = parseInt(path.slice(1));
+
+	if (isNaN(parsed_key)) {
+		return false;
+	}
+
+	return parsed_key >= StatusCode.BAD_REQUEST;
+}
+
+function getCustomPageTypeForPath(path: string): CustomPageType {
+	if (isDate(path)) {
+		return CustomPageType.DATE;
+	}
+
+	if (isError(path)) {
+		return CustomPageType.ERROR;
+	}
+
+	if (isIndexPath(path)) {
+		return CustomPageType.INDEX;
+	}
+
+	return CustomPageType.BLANK;
+}
+
+export default getCustomPageTypeForPath;

package/src/server/utility/get-element-id-for-block.ts

@@ -0,0 +1,15 @@
+import Block from 'type/block';
+import BlockMetadata from 'type/block-metadata';
+import parseIndexPath from 'server/utility/parse-index-path';
+
+function getElementIdForBlock(block: Block, metadata: BlockMetadata): string {
+	const {page_path, index_path} = metadata;
+	const normalized_page_path = page_path.replace(/\//g, '-');
+	const path_parts = parseIndexPath(index_path);
+	const index_component = path_parts.join('-');
+	const id = `block-${normalized_page_path}-${index_component}`;
+
+	return id.replace(/-+/g, '-');
+}
+
+export default getElementIdForBlock;

package/src/server/utility/get-emoji-for-block-type.ts

@@ -0,0 +1,39 @@
+import {InvariantViolation} from 'lib/errors';
+
+import BlockType from 'enum/block-type';
+import Emoji from 'enum/emoji';
+
+function getEmojiForBlockType(block_type: BlockType): Emoji {
+	switch (block_type) {
+		case BlockType.NOTE:
+			return Emoji.NOTEPAD;
+
+		case BlockType.IMAGE:
+			return Emoji.CAMERA;
+
+		case BlockType.AUDIO:
+			return Emoji.MICROPHONE;
+
+		case BlockType.TODO:
+			return Emoji.COMPLETED_CHECKMARK;
+
+		case BlockType.HEADER:
+			return Emoji.PLACARD;
+
+		case BlockType.FOLDER:
+			return Emoji.FOLDER;
+
+		case BlockType.MULTI_COLUMN:
+			return Emoji.BAR_CHART;
+
+		case BlockType.LINK:
+			return Emoji.LINK;
+
+		default:
+			throw new InvariantViolation(`
+				Unable to determine emoji for block type: ${block_type}
+			`);
+	}
+}
+
+export default getEmojiForBlockType;

package/src/server/utility/get-emoji-for-tool-type.ts

@@ -0,0 +1,20 @@
+import ToolType from 'enum/tool-type';
+import Emoji from 'enum/emoji';
+
+const ToolTypesToEmojis: Record<ToolType, Emoji> = {
+	[ToolType.LOCK]: Emoji.LOCKED,
+	[ToolType.HOME]: Emoji.HOUSE,
+	[ToolType.TODAY]: Emoji.SUNSHINE,
+	[ToolType.IMAGE]: Emoji.CAMERA,
+	[ToolType.AUDIO]: Emoji.MICROPHONE,
+	[ToolType.NOTE]: Emoji.NOTEPAD,
+	[ToolType.SETTINGS]: Emoji.GEAR,
+	[ToolType.FOLDER]: Emoji.FOLDER,
+	[ToolType.TODO]: Emoji.COMPLETED_CHECKMARK
+};
+
+function getEmojiForToolType(tool_type: ToolType): Emoji {
+	return ToolTypesToEmojis[tool_type];
+}
+
+export default getEmojiForToolType;

package/src/server/utility/get-end-of-month.ts

@@ -0,0 +1,13 @@
+import createDate from 'server/utility/create-date';
+
+function getEndOfMonth(date: Date): Date {
+	const new_date = createDate(date);
+
+	new_date.setUTCMonth(date.getUTCMonth() + 1);
+	new_date.setUTCDate(1);
+	new_date.setUTCDate(new_date.getUTCDate() - 1);
+
+	return new_date;
+}
+
+export default getEndOfMonth;

package/src/server/utility/get-end-of-week.ts

@@ -0,0 +1,13 @@
+import createDate from 'server/utility/create-date';
+
+function getEndOfWeek(date: Date): Date {
+	const new_date = createDate(date);
+	const current_day = new_date.getUTCDay();
+	const delta = 6 - current_day
+
+	new_date.setUTCDate(new_date.getUTCDate() + delta);
+
+	return new_date;
+}
+
+export default getEndOfWeek;

package/src/server/utility/get-filepath-for-folder-block.ts

@@ -0,0 +1,23 @@
+import Path from 'path';
+
+import FolderBlock from 'type/block/folder';
+import getPathForFolderBlock from 'server/utility/get-path-for-folder-block';
+
+type GetPathInput = {
+	readonly base_path: string;
+	readonly public_directory: string;
+	readonly block: FolderBlock;
+};
+
+function getFilepathForFolderBlock(input: GetPathInput): string {
+	const {base_path, public_directory, block} = input;
+
+	const path = getPathForFolderBlock({
+		base_path,
+		block
+	});
+
+	return Path.resolve(public_directory, `.${path}`);
+}
+
+export default getFilepathForFolderBlock;

package/src/server/utility/get-hex-for-color.ts

@@ -0,0 +1,31 @@
+import {InvariantViolation} from 'lib/errors';
+
+import Color from 'enum/color';
+
+const ColorsToHex: Record<Color, string> = {
+	[Color.BLUE]: '#09F',
+	[Color.YELLOW]: '#FC3',
+	[Color.FUSCHIA]: '#F36',
+	[Color.MAROON]: '#C06',
+	[Color.ORANGE]: '#F83',
+	[Color.PURPLE]: '#66C',
+	[Color.RED]: '#F00',
+	[Color.BLACK]: '#000',
+	[Color.WHITE]: '#FFF',
+	[Color.GREY]: '#777',
+	[Color.GREEN]: '#0C9'
+};
+
+function getHexForColor(color: Color): string {
+	const hex = ColorsToHex[color];
+
+	if (hex === undefined) {
+		throw new InvariantViolation(`
+			Unable to determine hex for color: ${color}
+		`);
+	}
+
+	return hex;
+}
+
+export default getHexForColor;

package/src/server/utility/get-label-for-time-place-visibility.ts

@@ -0,0 +1,23 @@
+import {InvariantViolation} from 'lib/errors';
+
+import Emoji from 'enum/emoji';
+import TimePlaceVisibility from 'enum/time-place-visibility';
+
+function getLabelForTimePlaceVisibility(visibility: TimePlaceVisibility): string {
+	switch (visibility) {
+		case TimePlaceVisibility.NONE:
+			return `${Emoji.NONE} none`;
+		case TimePlaceVisibility.TIME:
+			return `${Emoji.CLOCK} time`;
+		case TimePlaceVisibility.PLACE:
+			return `${Emoji.GRID_GLOBE} place`;
+		case TimePlaceVisibility.BOTH:
+			return `${Emoji.CLOCK}${Emoji.GRID_GLOBE} both`;
+		default:
+			throw new InvariantViolation(`
+				Unsupported time/place visibility: ${visibility}
+			`);
+	}
+}
+
+export default getLabelForTimePlaceVisibility;

package/src/server/utility/get-month-name.ts

@@ -0,0 +1,18 @@
+import {InvariantViolation} from 'lib/errors';
+
+import MonthNames from 'constant/month-names';
+
+function getMonthName(date: Date): string {
+	const month_index = date.getUTCMonth();
+	const month_name = MonthNames[month_index];
+
+	if (month_name === undefined) {
+		throw new InvariantViolation(`
+			Unable to determine month name for date: ${date.toString()}
+		`);
+	}
+
+	return month_name;
+}
+
+export default getMonthName;

package/src/server/utility/get-next-day.ts

@@ -0,0 +1,7 @@
+import addDays from 'server/utility/add-days';
+
+function getNextDay(date: Date): Date {
+	return addDays(date, 1);
+}
+
+export default getNextDay;

package/src/server/utility/get-next-month.ts

@@ -0,0 +1,12 @@
+import createDate from 'server/utility/create-date';
+
+function getNextMonth(date: Date): Date {
+	const month = date.getUTCMonth();
+	const new_date = createDate(date);
+
+	new_date.setUTCMonth(month + 1);
+
+	return new_date;
+}
+
+export default getNextMonth;

package/src/server/utility/get-next-week.ts

@@ -0,0 +1,12 @@
+import getEndOfWeek from 'server/utility/get-end-of-week';
+import getStartOfWeek from 'server/utility/get-start-of-week';
+import addDays from 'server/utility/add-days';
+
+function getNextWeek(date: Date): Date {
+	const end_of_week = getEndOfWeek(date);
+	const start_of_next_week = addDays(end_of_week, 1);
+
+	return getStartOfWeek(start_of_next_week);
+}
+
+export default getNextWeek;

package/src/server/utility/get-next-year.ts

@@ -0,0 +1,13 @@
+import createDate from 'server/utility/create-date';
+
+function getNextYear(date: Date): Date {
+	const new_date = createDate(date);
+
+	new_date.setUTCFullYear(new_date.getUTCFullYear() + 1);
+	new_date.setUTCMonth(0);
+	new_date.setUTCDate(1);
+
+	return new_date;
+}
+
+export default getNextYear;

package/src/server/utility/get-ordinal-label-for-week.ts

@@ -0,0 +1,11 @@
+import getMonthName from 'server/utility/get-month-name';
+import getOrdinalOfWeekWithinMonth from 'server/utility/get-ordinal-of-week-within-month';
+
+function getOrdinalLabelForWeek(week: Date): string {
+	const month = getMonthName(week);
+	const ordinal = getOrdinalOfWeekWithinMonth(week);
+
+	return `${ordinal} week of ${month}`;
+}
+
+export default getOrdinalLabelForWeek;

package/src/server/utility/get-ordinal-of-week-within-month.ts

@@ -0,0 +1,15 @@
+import getShortOrdinal from 'server/utility/get-short-ordinal';
+
+function getIndexOfWeekWithinMonth(date: Date): number {
+	const day_index = date.getUTCDate();
+
+	return Math.ceil((day_index - 1) / 7);
+}
+
+function getOrdinalOfWeekWithinMonth(date: Date): string {
+	const index = getIndexOfWeekWithinMonth(date);
+
+	return getShortOrdinal(index + 1);
+}
+
+export default getOrdinalOfWeekWithinMonth;

package/src/server/utility/get-padded-date.ts

@@ -0,0 +1,11 @@
+function getPaddedDate(date: Date): string {
+	const numeric_date = date.getUTCDate();
+
+	if (numeric_date < 10) {
+		return `0${numeric_date}`;
+	}
+
+	return numeric_date.toString();
+}
+
+export default getPaddedDate;

package/src/server/utility/get-parent-index-path.ts

@@ -0,0 +1,18 @@
+import {InvalidError} from 'lib/errors';
+
+import parseIndexPath from 'server/utility/parse-index-path';
+import createIndexPath from 'server/utility/create-index-path';
+
+function getParentIndexPath(index_path: string): string {
+	const parts = parseIndexPath(index_path);
+
+	parts.pop();
+
+	if (parts.length === 0) {
+		throw new InvalidError(`Can't get parent of path: ${index_path}`);
+	}
+
+	return createIndexPath(parts);
+}
+
+export default getParentIndexPath;

package/src/server/utility/get-path-for-folder-block.ts

@@ -0,0 +1,25 @@
+import Path from 'path';
+
+import FolderBlock from 'type/block/folder';
+import createSlug from 'server/utility/create-slug';
+
+type GetPathInput = {
+	readonly base_path: string;
+	readonly block: FolderBlock;
+};
+
+function getPathForFolderBlock(input: GetPathInput): string {
+	const {base_path, block} = input;
+
+	const title = block.title;
+
+	if (title === '') {
+		return `${base_path}/...`;
+	}
+
+	const slug = createSlug(title);
+
+	return Path.resolve(base_path, `./${slug}`);
+}
+
+export default getPathForFolderBlock;

package/src/server/utility/get-path-from-url.ts

@@ -0,0 +1,13 @@
+import {URL} from 'url';
+
+import validateUrl from 'server/utility/validate-url';
+
+function getPathFromUrl(raw_url: string): string {
+	validateUrl(raw_url);
+
+	const url = new URL(raw_url);
+
+	return url.pathname;
+}
+
+export default getPathFromUrl;

package/src/server/utility/get-previous-index-path.ts

@@ -0,0 +1,27 @@
+import parseIndexPath from 'server/utility/parse-index-path';
+import createIndexPath from 'server/utility/create-index-path';
+
+function getPreviousIndexPath(index_path: string): string {
+	const parts = parseIndexPath(index_path);
+	const final_part = parts.pop();
+
+	if (final_part === undefined) {
+		return createIndexPath([0]);
+	}
+
+	if (final_part === 0) {
+		if (parts.length === 0) {
+			return createIndexPath([0]);
+		} else {
+			return createIndexPath(parts);
+		}
+	}
+
+	const previous_part = final_part - 1;
+
+	parts.push(previous_part);
+
+	return createIndexPath(parts);
+}
+
+export default getPreviousIndexPath;

package/src/server/utility/get-previous-month.ts

@@ -0,0 +1,12 @@
+import createDate from 'server/utility/create-date';
+
+function getPreviousMonth(date: Date): Date {
+	const month = date.getUTCMonth();
+	const new_date = createDate(date);
+
+	new_date.setUTCMonth(month - 1);
+
+	return new_date;
+}
+
+export default getPreviousMonth;

package/src/server/utility/get-previous-week.ts

@@ -0,0 +1,11 @@
+import getStartOfWeek from 'server/utility/get-start-of-week';
+import subtractDays from 'server/utility/subtract-days';
+
+function getPreviousWeek(date: Date): Date {
+	const start_of_week = getStartOfWeek(date);
+	const end_of_previous_week = subtractDays(start_of_week, 1);
+
+	return getStartOfWeek(end_of_previous_week);
+}
+
+export default getPreviousWeek;

package/src/server/utility/get-previous-year.ts

@@ -0,0 +1,13 @@
+import createDate from 'server/utility/create-date';
+
+function getPreviousYear(date: Date): Date {
+	const new_date = createDate(date);
+
+	new_date.setUTCFullYear(new_date.getUTCFullYear() - 1);
+	new_date.setUTCMonth(0);
+	new_date.setUTCDate(1);
+
+	return new_date;
+}
+
+export default getPreviousYear;